Skip to main content
GET
List invoices
amount, fiat_amount, and tax_amount are decimal currency units, same as everywhere else in this API. 19.99 means EUR 19.99, not cents. See Money model.

Authorizations

x-api-key
string
header
required

Your secret key, from app.agentaos.ai -> Settings -> Developers -> API Keys. The key's prefix is both its identity and its environment: sk_test_... (sandbox, free, no verification) or sk_live_... (real money, requires business verification). A missing or invalid key returns 401.

Query Parameters

limit
integer
default:20

Items per page. Capped server-side at 5000.

Required range: 1 <= x <= 5000
offset
integer
default:0

Number of items to skip, for the next page.

Required range: x >= 0
from
string

ISO 8601 date or datetime, inclusive lower bound.

to
string

ISO 8601 date or datetime, inclusive upper bound.

status
enum<string>
Available options:
all,
issued,
paid,
voided
fiatCurrency
enum<string>

Filter to rows settled/presented in this fiat currency.

Available options:
EUR,
USD
networks
string

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.

items
object[]
required
total
integer
required
hasMore
boolean
required