Account Balance

Get account balance info

GET https://billing.aimlapi.com/v1/billing/balance

Headers

Name	Value
Authorization	Bearer <token>
Content-Type	application/json

Body

-

Response Schema

Field	Description
balance	The total credits associated with the provided API key.
lowBalance	True if the balance is below the threshold.
lowBalanceThreshold	Threshold for switching to low balance status.
lastUpdated	The date of the request — i.e., the current date.
autoDebitStatus	Indicates whether auto top-up is enabled for the plan.
status	The status of the plan associated with the provided API key.
statusExplanation	A more detailed explanation of the plan status.

Example

cURL

curl https://billing.aimlapi.com/v1/billing/balance \
  -H "Authorization: Bearer <YOUR_AIMLAPI_KEY>" \
  -H "Content-Type: application/json"

HTTP

Python

JavaScript

Response

{
  "balance": 551564495,
  "lowBalance": false,
  "lowBalanceThreshold": 10000,
  "lastUpdated": "2025-11-10T10:01:56.824Z",
  "autoDebitStatus": "disabled",
  "status": "current",
  "statusExplanation": "Balance is current and up to date"
}