get_account_financials is only available when the seller declares account_financials: true in get_adcp_capabilities. It applies to operator-billed accounts only. For agent-billed accounts, the agent’s own billing system is the source of truth.
Response Time: ~1s.
Request Schema: /schemas/3.3.0-beta.0/account/get-account-financials-request.json
Response Schema: /schemas/3.3.0-beta.0/account/get-account-financials-response.json
Quick start
Check remaining credit before launching a campaign:Request parameters
Response
Success response: Returns financial data for the account. Onlyaccount, currency, period, and timezone are guaranteed — everything else depends on what the seller exposes.
Error response:
errors— Array of operation-level errors. No financial data is present.
errors, never both.
Being notified of new invoices
Sellers that listinvoice in account.change_feed.resource_types record a change when an invoice is created, changes status, or has its amount or period corrected. Subscribe to account.change_recorded and drain list_account_changes instead of polling; each record carries the invoice_id as resource.resource_id, and the buyer rereads this task to get the invoice. The feed is experimental. Buyers of sellers without it must keep polling.
Common scenarios
Budget check before campaign launch
Prepay balance monitoring
Error handling
Next steps
- list_accounts — Discover accounts and check their status
- get_adcp_capabilities — Check
account_financialsbefore calling this task - Accounts and agents — Billing models and account references