Skip to main content
GET
/
api
/
v1
/
credits
/
balance
curl "https://app.talkover.ai/api/v1/credits/balance" \
  -H "Authorization: Bearer your_user_session_token"

{
  "success": true,
  "data": {
    "balance": 250.00,
    "currency": "USD",
    "auto_topup_enabled": true,
    "as_of": "2024-01-15T19:30:00Z"
  }
}

​
Get Credits Balance

Retrieve the current credit balance for the account.
This endpoint is part of the Account API and is authenticated with a user session token.

​
Endpoint

GET /api/v1/credits/balance

​
Request headers

​
Authorization
string
required
User session token. Format: Bearer <user_session_token>.

​
Examples

curl "https://app.talkover.ai/api/v1/credits/balance" \
  -H "Authorization: Bearer your_user_session_token"

​
Response

{
  "success": true,
  "data": {
    "balance": 250.00,
    "currency": "USD",
    "auto_topup_enabled": true,
    "as_of": "2024-01-15T19:30:00Z"
  }
}

​
Notes

  • Balance updates in near real-time as calls complete and recharges process.
  • For per-agent or per-call cost detail, use Get Agent Pricing.