Skip to main content
GET
/
api
/
v2
/
balance
Token Balance
curl --request GET \
  --url https://api.example.com/api/v2/balance
{
  "token_balance": 123,
  "plan": "<string>",
  "plan_expires_at": {}
}

​
Request

curl https://neuralbox.top/api/v2/balance \
  -H "Authorization: Bearer nb_YOUR_API_KEY"

​
Response

{
  "token_balance": 283,
  "plan": "vip",
  "plan_expires_at": "2026-04-08T00:00:00Z"
}
​
token_balance
integer
Current balance — subscription tokens + any purchased token packages combined.
​
plan
string
Active plan: free (Starter) | basic | pro | vip | elite
​
plan_expires_at
string | null
ISO 8601 expiry date of the subscription. null for Starter plan.
The full user profile including token_limit and rate limits is available via GET /api/v2/user/me.