Check credit balance

GET/api/v2/credits

Returns the total credits currently available to the user who owns the API key. This is a synchronous, read-only endpoint. It does not create a job or consume credits.

Example request

cURL
curl "https://revor.ai/api/v2/credits" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME"

Example response

JSON
{
  "ok": true,
  "request_id": "req_xxx",
  "available_credits": 1280,
  "as_of": "2026-08-25T08:00:00.000Z"
}

Response fields

Field	Type	Description
`available_credits`	number	Currently available credits, with a minimum of `0`.
`as_of`	ISO 8601 string	Time at which this balance was calculated.

available_credits already accounts for credit groups, expiration dates, subscription status, and related rules. Clients should not calculate a replacement value by summing credit transactions.

Errors

HTTP	Code	Description
`401`	`api_key_invalid`	The API key is invalid.
`403`	`permission_denied`	The key does not have permission to read credits.
`429`	`api_rate_limit_exceeded`	The request was rate limited.
`500`	`credits_query_failed`	The balance query failed; do not interpret this error as a zero balance.