Account Balance

Get account balance info

You can query your account balance and other billing details through this API. To make a request, you only need your AIMLAPI key obtained from your account dashboard.

get

Body

application/json

–Optional

Responses

200Success

application/json

balancenumberRequired

The total credits associated with the provided API key.

Example: 10000000

lowBalancebooleanRequired

True if the balance is below the threshold.

Example: false

lowBalanceThresholdnumberRequired

Threshold for switching to low balance status.

Example: 10000

lastUpdatedstring · date-timeRequired

The date of the request — i.e., the current date.

Example: 2025-11-25T17:45:00Z

autoDebitStatusstringRequired

Indicates whether auto top-up is enabled for the plan.

Example: disabled

statusstringRequired

The status of the plan associated with the provided API key.

Example: current

statusExplanationstringRequired

A more detailed explanation of the plan status.

Example: Balance is current and up to date

get

/v1/billing/balance

cURLJavaScriptPython

curl -L \
  --request GET \
  --url 'https://api.aimlapi.com/v1/billing/balance' \
  --header 'Authorization: Bearer <YOUR_AIMLAPI_KEY>' \
  --header 'Content-Type: application/json'

200Success

{
  "balance": 10000000,
  "lowBalance": false,
  "lowBalanceThreshold": 10000,
  "lastUpdated": "2025-11-25T17:45:00Z",
  "autoDebitStatus": "disabled",
  "status": "current",
  "statusExplanation": "Balance is current and up to date"
}