Returns a FOCUS compliant billing report as a CSV download, spanning every team in your organization. Each invoiced billing customer is reported as a BillingAccount. Under shared (pooled) billing — one billing customer covering multiple teams — each row is additionally attributed to the calling team via the SubAccountId / SubAccountName columns. SubAccountId is that team's own billing customer ID, so both account columns share one identifier namespace.

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

Must be called with a key on the organization's root team.

Supports three data sources:

• estimate: Real-time usage estimates for a date range. Under pooled billing every row is attributed to the calling team.
• tagged-estimate: Those same estimates with the Tags column populated from the X-Fal-Tags tags set on your requests. Requires tagged reporting to be enabled for the organization; recent usage is delayed relative to estimate.
• invoice: Finalized invoice data for a billing month. Under pooled billing, per-team SubAccount attribution is available on endpoint (Model API) lines that carry a caller; app and compute lines carry no caller and have no SubAccount.

Use team_username to restrict the report to a single team. Under shared (pooled) billing this is rejected for source=invoice — the invoice is issued to one billing customer shared across teams and cannot be split per team; use source=estimate for per-team figures.

Invoice reports default to the most recently available billing month. Usage estimates default to the last 24 hours, with a maximum 90-day date range.

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