> ## Documentation Index
> Fetch the complete documentation index at: https://docs.v2.certopaybrasil.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List All Customers — GET /api/customers Reference

> GET /api/customers — Retrieve all customers registered in your CertoPay account. Returns an array of customer objects with full details.

Use this endpoint to retrieve every customer registered under your CertoPay account. The response is an array of customer objects, each containing the same fields returned when a customer is first created. This is useful for building dashboards, reconciling buyer data, or looking up a customer UUID before placing an order.

## Request

<ParamField header="X-Api-Key" type="string" required>
  Your CertoPay secret API key. Include it in every request as `X-Api-Key: sk_live_sua_chave_aqui`.
</ParamField>

This endpoint accepts no request body or query parameters.

## Response

A successful request returns **HTTP 200 OK** with an array of customer objects. Each object in the array has the following shape:

<ResponseField name="id" type="string">
  Unique UUID identifying the customer.
</ResponseField>

<ResponseField name="name" type="string">
  Full name of the customer.
</ResponseField>

<ResponseField name="email" type="string">
  Email address of the customer.
</ResponseField>

<ResponseField name="document" type="string">
  CPF number (11 digits) of the customer.
</ResponseField>

<ResponseField name="phone" type="string">
  Phone number of the customer.
</ResponseField>

<ResponseField name="createdAt" type="string">
  ISO 8601 timestamp of when the customer record was created.
</ResponseField>

## Example

```bash theme={null}
curl https://v2.certopaybrasil.com/api/customers \
  -H "X-Api-Key: sk_live_sua_chave_aqui"
```

```json 200 OK theme={null}
[
  {
    "id": "uuid-do-customer",
    "name": "João da Silva",
    "email": "joao@email.com",
    "document": "12345678900",
    "phone": "(11) 99999-9999",
    "createdAt": "2026-06-26T10:00:00Z"
  },
  {
    "id": "uuid-do-customer-2",
    "name": "Maria Oliveira",
    "email": "maria@email.com",
    "document": "98765432100",
    "phone": "(21) 97777-7777",
    "createdAt": "2026-06-25T09:30:00Z"
  }
]
```