Get Balance
Return the prepaid balance of the account that owns this API key, in USD. Built for server-side monitoring: poll it and top up before the balance is exhausted. Values are live (Cache-Control: no-store). Alert on balance — the amount you can spend right now, gift credit included. While requests are in flight the gateway holds an estimated cost in reserved_balance; when each request settles, the unused part of the hold returns to balance, so balance can dip briefly under concurrency while total_balance stays steady. This endpoint has its own rate limit of 60 requests per minute per key and does not consume your inference rate limit.
Full reference for every endpoint: Markdown · OpenAPI 3.1 JSON
Authenticate with your API Key. Get your API Key in the Router One console; the format is sk-xxx.
In: header
Response Body
application/json
application/json
application/json
curl -X GET "https://api.router.one/v1/balance"{
"object": "balance",
"currency": "USD",
"balance": 12.345678,
"reserved_balance": 0.5,
"total_balance": 12.845678
}{
"error": {
"message": "invalid api key",
"type": "authentication_error",
"code": "AUTH_INVALID_API_KEY",
"request_id": "290dd478f91d8aec68f7535e871376eb"
}
}{
"error": {
"message": "rate limit exceeded",
"type": "rate_limit_error",
"code": "RATE_LIMIT_EXCEEDED",
"request_id": "290dd478f91d8aec68f7535e871376eb"
}
}