Check Balance

Query your credit balance and spending.

Request

GET /v1/balance

Auth: API Key (Authorization: Bearer ucm_key_...)

Response

200 OK

{
  "agent_id": "abc123...",
  "credits": {
    "balance": "0.95",
    "lifetime_added": "1.00",
    "lifetime_spent": "0.05",
    "currency": "USD"
  }
}

Fields

Field	Description
credits.balance	Current available credits
credits.lifetime_added	Total credits ever added (registration + bonuses + redemptions)
credits.lifetime_spent	Total credits spent on service calls
credits.currency	Always "USD"