Invoices

List invoices

Paginated. Every checkout issues an invoice: issued the moment the checkout is created, paid once the payment settles, or voided if cancelled. The seller of record is our Estonian entity, AgentaOS's Merchant of Record entity, unless the payment settled to your own on-chain wallet (seller_mode: "crypto"), in which case you're the seller.

get/gateway/invoices

Request

  • Base URL: https://api.agentaos.ai/api/v1
  • URL: https://api.agentaos.ai/api/v1/gateway/invoices
  • Auth: API key in header x-api-key

Query parameters

limitinteger

Items per page. Capped server-side at 5000.

offsetinteger

Number of items to skip, for the next page.

fromstring

ISO 8601 date or datetime, inclusive lower bound.

tostring

ISO 8601 date or datetime, inclusive upper bound.

status'all' | 'issued' | 'paid' | 'voided'
fiatCurrency'EUR' | 'USD'

Filter to rows settled/presented in this fiat currency.

networksstring

Comma-separated CAIP-2 network IDs to filter by, e.g. eip155:8453,eip155:84532. Ignored if your API key is network-scoped.

Response

A page of invoices.

totalinteger required
hasMoreboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.