---
title: "List customers"
method: GET
path: "/gateway/customers"
tags: ["Customers"]
---

# List customers

`GET /gateway/customers`

## Request

- Base URL: `https://api.agentaos.ai/api/v1`
- URL: `https://api.agentaos.ai/api/v1/gateway/customers`
- Auth: API key in header `x-api-key`

Paginated, newest first, no filters beyond pagination. A customer record is created automatically the first time someone pays you (or you issue them an invoice) with an email attached. There is no `POST` create endpoint: this is a read-only surface. Every field on this resource is camelCase on the wire.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

A page of customers.

- CustomerListResponse
  - `items` Customer[], required
    - `id` string, uuid, required
    - `email` string, email, required
    - `name` string, nullable, required
    - `country` string, nullable, required: ISO 3166-1 alpha-2, the customer's place of supply for destination-VAT purposes.
    - `vatNumber` string, nullable, required: EU VAT number, if given, for B2B reverse charge.
    - `stripeCustomerId` string, nullable, required: null until this customer's first saved-card charge or subscription (card/bank rail only).
    - `createdAt` string, date-time, required
  - `total` integer, required
  - `hasMore` boolean, required

## Other responses

- `401`: Missing or invalid `x-api-key`.

---

[API](https://skmtc.dev/agentaos/apis/agentaos-gateway-api.md) · [All operations](https://skmtc.dev/agentaos/apis/agentaos-gateway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentaos/apis/agentaos-gateway-api/revisions/3a8ad3c6b965?raw)