Skip to main content
GET
List customers
Every field on this resource is camelCase on the wire, unlike Payment Links, Checkouts, Invoices, and Transactions. See Naming convention.
A customer is scoped to one organization and one environment: a test-mode buyer and a live-mode buyer with the same email are two separate records. country/vatNumber are remembered from the most recent checkout that supplied them and never blanked by a later checkout that omits them.

Checkouts

Pre-fill buyerEmail, buyerName, buyerCountry, and buyerVat to populate this record.

Invoices

Every invoice carries the same buyer fields.

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 100.

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

Number of items to skip, for the next page.

Required range: x >= 0

Response

A page of customers.

items
object[]
required
total
integer
required
hasMore
boolean
required