Balance API

Query account balance and usage information via API.

Endpoint

http

GET https://api.tk-novalink.com/v1/dashboard/billing/subscription

Request Example

bash

curl -X GET "https://api.tk-novalink.com/v1/dashboard/billing/subscription" \
  -H "Authorization: Bearer sk-xxxxxxxx"

Response Example

json

{
  "object": "billing_subscription",
  "has_payment_method": true,
  "soft_limit_usd": 0,
  "hard_limit_usd": 100.00,
  "system_hard_limit_usd": 100.00,
  "access_until": 1735689600
}

Usage Query

Query usage details for a specific time range:

http

GET https://api.tk-novalink.com/v1/dashboard/billing/usage?start_date=2026-01-01&end_date=2026-12-31