Skip to main content
Query financial status for an operator-billed account — spend summary, credit or prepay balance, payment status, and invoice history. This gives budget-aware agents the context they need to make spend decisions without leaving the protocol. 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. Only account, 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.
Note: Responses use discriminated unions — you get either financial data OR errors, never both.

Being notified of new invoices

Sellers that list invoice 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