Get Credits

Read OpenRouter-compatible credit balance and usage.

GET/api/v1/credits
Management Key Required
This endpoint requires a management API key (sk-mgmt-... prefix). Regular routing keys will receive a 403 Forbidden response.

Request Example

bash
curl https://api.therouter.ai/api/v1/credits \
  -H "Authorization: Bearer sk-mgmt-..."

Response

json
{
  "data": {
    "total_credits": 950.5,
    "total_usage": 49.5
  }
}
Alternative Endpoint
For dashboard-style billing details (balance, current_period, lifetime, quotas), use GET /v1/customer/credits.