Skip to main content
GET
Get the account balance
Required API key scope: billing:read

Authorizations

Authorization
string
header
required

Runpod API key authentication. Generate an API key in the Runpod console and send it in the Authorization header as Bearer <api_key>. Keys are scoped to the permissions granted when created; requests may return 403 when a valid key lacks access to the requested resource or action.

Console sessions (Clerk JWTs) act for the signed-in user. To act for a team instead, also send X-Team-Id: <team_id>; it applies only when the user owns or belongs to that team, otherwise the request runs against the user's own account. API keys created inside a team already act for that team and do not need the header.

Response

OK

balanceAmount
number<double>
required

Account balance in USD. On a prepaid account, new Pods and workers are refused when it runs out.

Example:

42.18

billingMode
enum<string>
required

PREPAID accounts spend from the balance. POSTPAID accounts are invoiced, so a low balance doesn't stop them.

Available options:
PREPAID,
POSTPAID
Example:

"PREPAID"

Last modified on November 18, 2026