Customers

The Customers page lists the people who paid you and the people you billed. AgentaOS adds a customer when someone pays you for the first time. It also adds one when you bill someone by email, on an invoice or on a checkout your server creates. You do not add or import customers yourself. A customer’s details come from what the buyer typed at checkout, or from what you entered on the invoice: email, name, country, and VAT number. Test mode and live mode keep separate customer lists.

The Customers page

In the sidebar, click Customers. Each row shows:

The customer’s name or email.
Revenue: what the customer paid you, before VAT.
Payments: how many payments they made.
Last active: their most recent activity.

A customer you billed who has not paid yet shows a dash for revenue and payments. Type in Search customers to find a customer by name or email. Click Create invoice in a row to bill that customer. Click a row to open the customer. The customer page shows their details, when you first saw them, and their invoices.

From code

The API returns the same list. It is read-only: there is no call to create or update a customer. The full reference is in Customers (SDK) and agenta customers.

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_..."

The list is newest first, and each call returns { items, total, hasMore }.

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

string

Customer UUID.

string

Customer email.

string | null

Customer name.

string | null

ISO 3166-1 alpha-2 country code.

string | null

VAT number, if the customer gave one.

string | null

Lowercase currency of this customer record, for example eur. A buyer has one record per currency, so the same email can appear once per currency.

string

ISO 8601. When AgentaOS first added this customer.

Next steps

Invoices

Every invoice a customer has.

Subscriptions

Customers with a running subscription.

Getting started

Grow

Build with AI agents

Integrations

Sell

Platforms

Merchant of Record

Payouts

Webhooks

For customers

The Customers page

From code

Next steps

Invoices

Subscriptions

​The Customers page

​From code

​Next steps

Invoices

Subscriptions

The Customers page

From code

Next steps