Account

Returns billing information for the authenticated account. Use the expand parameter to include additional details.

Expandable Fields:

  • credits — Current credit balance and currency

Common Use Cases:

  • Monitor available credit balance programmatically
  • Display balance in custom dashboards

Required permissions: billing:usage:read. Key presets that include them: BILLING, READONLY, FULL. See key permissions.

get/account/billing

Request

  • Base URL
    https://api.fal.ai/v1
  • URL
    https://api.fal.ai/v1/account/billing
  • Auth
    API key in header Authorization

Query parameters

string
OR
string[]

Response

Account billing information retrieved successfully

usernamestring required

Account username

Example response

{
  "username": "my-team",
  "credits": {
    "current_balance": 24.5,
    "currency": "USD"
  }
}

Changes

    • info

      the endpoint scheme security readonlyApiKey was added to the API

    • info

      the endpoint scheme security adminApiKey was removed from the API