Customers

A customer record is created the moment someone pays you for the first time: email, name, country, and VAT number, pulled from what they entered at checkout. This is a read surface, the same list the dashboard Customers page shows. There’s no create or update: you can’t add a customer that hasn’t paid, and buyer details come from the checkout, not from you editing a record after the fact.

List customers

Paginated: every list call returns { items, total, hasMore }.

SDK
CLI
cURL

const page = await agentaos.customers.list({ limit: 20, offset: 0 });
console.log(page.total, page.hasMore);

agenta customers list --limit 20

curl "https://api.agentaos.ai/api/v1/gateway/customers?limit=20&offset=0" \
  -H "x-api-key: sk_live_..."

Response

string

Customer UUID.

string

Customer email.

string | null

Customer name.

string | null

ISO 3166-1 alpha-2 country code.

string | null

VAT number on file, if provided.

string | null

Underlying customer ID from the card processor, for card/bank payers.

string

ISO 8601, when this buyer first paid you.

{
  "items": [
    {
      "id": "a1b2c3d4-...",
      "email": "john@example.com",
      "name": "John Doe",
      "country": "DE",
      "vatNumber": "DE123456789",
      "stripeCustomerId": "cus_...",
      "createdAt": "2026-03-17T02:00:00.000Z"
    }
  ],
  "total": 1,
  "hasMore": false
}

Next steps

Subscriptions

See which customers have an active subscription.

Invoices

Every invoice a customer has been issued.

Checkouts

Pre-fill buyer details to skip the checkout form next time.

Getting Started

Build with AI agents

Sell

Merchant of Record

Webhooks

For customers

Legacy

List customers

Response

Next steps

Subscriptions

Invoices

Checkouts

​List customers

​Response

​Next steps

Subscriptions

Invoices

Checkouts

List customers

Response

Next steps