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

# Listar clientes

> Lista clientes da conta

## Endpoint

<CodeGroup>
  ```bash cURL theme={null}
  curl -G https://api.upag.io/v1/customers \
    -H "Authorization: Bearer sk_test_your_api_key" \
    -d "limit=20" \
    -d "offset=0"
  ```
</CodeGroup>

## Resposta

`200 OK`

```json Response theme={null}
{
  "data": [
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "name": "John Customer",
      "email": "john@example.com",
      "document": { "number": "12345678901", "type": "cpf" },
      "phone": {
        "countryCode": "55",
        "areaCode": "11",
        "number": "999998888"
      },
      "address": {
        "street": "Rua A",
        "number": "100",
        "complement": "Apto 1",
        "neighborhood": "Centro",
        "city": "Sao Paulo",
        "state": "SP",
        "country": "BR",
        "zip": "01001000"
      },
      "createdAt": "2026-03-18T11:00:00.000Z",
      "updatedAt": "2026-03-18T11:00:00.000Z"
    }
  ],
  "count": 1
}
```