Balance API

Check your current dollar balance.

Get Balance

GET /v1/balance

Returns your developer balance in dollars. For user billing apps, passexternal_user_id or use/v1/users/:external_user_id/balance.

curl https://api.usequota.ai/v1/balance \
  -H "Authorization: Bearer sk-quota-your-api-key"

{
  "balance": "$98.50",
  "balance_microdollars": 98500000,
  "plan": "free",
  "user_id": "bc9aac4f-...",
  "billing_mode": "developer"
}

Field	Type	Description
`balance`	string	Current balance as a formatted dollar string
`balance_microdollars`	integer	Current balance in micro-dollars (1 = $0.000001) for precise calculations
`plan`	string	Current plan (e.g. "free")
`user_id`	string	Developer user ID
`billing_mode`	string	"developer" or "user"

Status	Code	Description
401	`invalid_api_key`	Missing or invalid API key

All errors return a JSON body:

{
  "error": {
    "code": "invalid_api_key",
    "message": "Missing or invalid API key"
  }
}