FAfal
Organization

Organization Billing Events

Changed on

Returns paginated individual billing event records across all teams in your organization, with each record attributed to a specific team via the username field. Each record includes a per-request cost breakdown in USD (cost_subtotal, cost_discount, cost_total; cost_estimate_nano_usd carries cost_total in nano USD).

Scoped to fal Model API billing events. Must be called with a key on the organization's root team.

Availability: This endpoint is available to enterprise customers with organizations enabled. Contact your account team or support@fal.ai to request access.

Key Features:

  • Organization-wide model-API billing event records across all teams
  • Filter by team(s) (team_username), endpoint, API key (api_key_id), request ID, and date range
  • Per-team attribution and per-request cost breakdown on every record
  • Cursor-based pagination for efficient large dataset queries
  • Limited to 100 records per page for performance
  • Date range capped at 90 days per request

See fal.ai docs for more details.

Required permissions: account:users:read, billing:usage:read, auth:keys:read. Key presets that include them: BILLING, FULL. See key permissions.

get/organization/billing-events

Request

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

Query parameters

limitinteger

Maximum number of items to return. Actual maximum depends on query type and expansion parameters.

Example:50
cursorstring

Pagination cursor from previous response. Encodes the page number.

Example:Mg==
string date-time
OR
string
string date-time
OR
string
string
OR
string[]
string
OR
string[]
string
OR
string[]
string
OR
string[]
string
OR
string[]

Response

Organization billing event data retrieved successfully

next_cursorstring nullable required

Cursor for the next page of results, null if no more pages

has_moreboolean required

Boolean indicating if more results are available (convenience field derived from next_cursor)

Changes

  • 479db2f9dcd6Revision changes
    • info

      the endpoint scheme security billingApiKey was added to the API

    • info

      the endpoint scheme security adminApiKey was removed from the API

  • 04f815c7612bRevision changes
    • info

      response property billing_events/items/output_units deprecated

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status