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

# Listar clientes

> Lista os clientes da sua conta, mais recentes primeiro, com paginação por cursor.

<Info>
  `GET /v1/customers`  ·  Requer o escopo `customers:read`
</Info>

Retorna os seus clientes, mais recentes primeiro, em um [objeto de lista](/api-reference/pagination).

## Parâmetros de query

<ParamField query="limit" type="integer" default="20">
  Registros a retornar, de `1` a `100`.
</ParamField>

<ParamField query="starting_after" type="string">
  Um ID de cliente (`cus_…`) a partir do qual paginar. Um valor desconhecido ou malformado retorna `400` (`invalid_cursor`).
</ParamField>

## Requisição

```bash cURL theme={null}
curl "https://api.moneydev.com.br/v1/customers?limit=2" \
  --header "Authorization: Bearer $ACCESS_TOKEN"
```

## Resposta

```json theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "cus_9b2c4f1a-3d5e-4a7b-8c9d-1e2f3a4b5c6d",
      "object": "customer",
      "name": "João da Silva",
      "email": "joao.silva@example.com",
      "phone": "+5511999999999",
      "tax_id": "12345678909",
      "status": "active",
      "metadata": {},
      "created_at": "2026-08-28T13:00:00.000Z",
      "updated_at": "2026-08-28T13:00:00.000Z"
    },
    {
      "id": "cus_1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "object": "customer",
      "name": "Maria Oliveira",
      "email": "maria@example.com",
      "phone": null,
      "tax_id": null,
      "status": "active",
      "metadata": {},
      "created_at": "2026-08-27T09:30:00.000Z",
      "updated_at": "2026-08-27T09:30:00.000Z"
    }
  ],
  "has_more": true,
  "next_cursor": "cus_1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
}
```

Veja [Paginação](/api-reference/pagination) para percorrer todas as páginas.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.