Account Billing - fal

GET

/

account

/

billing

Account Billing

curl --request GET \
  --url https://api.fal.ai/v1/account/billing \
  --header 'Authorization: <api-key>'

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

Authorizations

Authorization

string

header

required

Admin API key must be prefixed with "Key ", e.g. Authorization: Key YOUR_ADMIN_API_KEY

Query Parameters

expand

Data to include in the response. Use 'credits' to include current credit balance.

Example:

"credits"

Response

Account billing information retrieved successfully

Account billing information with optional expanded details

username

string

required

Account username

Example:

"my-team"

credits

object

Credit balance details. Only present when 'credits' is included in expand parameter.

Show child attributes

FOCUS Report Returns a FOCUS compliant billing report as a CSV download. > **Availability:** This endpoint is available to enterprise customers with FOCUS reports enabled. Contact your account team or support@fal.ai to request access. Supports two data sources: - **invoice**: Finalized invoice data for a billing month. Includes usage charges, credits, and taxes. - **estimate**: Real-time usage estimates for a date range. Pre-invoice data that may change once invoiced. The report follows the [FinOps FOCUS specification](https://focus.finops.org/) for cloud billing data interoperability. **Invoice reports** default to the most recently available billing month. **Usage estimates** default to the last 24 hours, with a maximum 90-day lookback.

⌘I

Account Billing

curl --request GET \
  --url https://api.fal.ai/v1/account/billing \
  --header 'Authorization: <api-key>'

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