> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentaos.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Customers
> The buyers who have paid you. Read-only, populated automatically from checkouts.
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](https://app.agentaos.ai) 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 }`.
```typescript theme={null}
const page = await agentaos.customers.list({ limit: 20, offset: 0 });
console.log(page.total, page.hasMore);
```
```bash theme={null}
agenta customers list --limit 20
```
```bash theme={null}
curl "https://api.agentaos.ai/api/v1/gateway/customers?limit=20&offset=0" \
-H "x-api-key: sk_live_..."
```
## Response
Customer UUID.
Customer email.
Customer name.
ISO 3166-1 alpha-2 country code.
VAT number on file, if provided.
Underlying customer ID from the card processor, for card/bank payers.
ISO 8601, when this buyer first paid you.
```json theme={null}
{
"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
See which customers have an active subscription.
Every invoice a customer has been issued.
Pre-fill buyer details to skip the checkout form next time.