---
title: "Listar clientes"
method: GET
path: "/customers/list"
---

# Listar clientes

`GET /customers/list`

Retorna todos os clientes que você cadastrou com suporte a paginação.

Você pode usar essa rota para visualizar todos os seus clientes e suas informações.

**Alternativa**: Você também pode visualizar e gerenciar seus clientes pelo [Dashboard da AbacatePay](https://app.abacatepay.com/clientes).

## Query parameters

- `after` string
- `before` string
- `limit` integer
- `startDate` string, date
- `endDate` string, date
- `id` string
- `email` string
- `taxId` string

## Response `200`

Lista de clientes retornada com sucesso.

- object
  - `data` Customer[] — Lista de clientes.
    - `id` string, required — Identificador único público do cliente
    - `devMode` boolean, required — Indica se o cliente foi criado em ambiente de testes.
    - `name` string, required — Nome completo do cliente
    - `cellphone` string, required — Celular do cliente
    - `email` string, required — E-mail do cliente
    - `taxId` string, required — CPF ou CNPJ do cliente
    - `country` string — País do cliente
    - `zipCode` string — CEP do cliente
    - `metadata` object — Metadados adicionais do cliente
  - `success` boolean — Se a requisição obteve sucesso ou não.
  - `error` string, nullable
  - `pagination` PaginationCursor — Informações de paginação baseada em cursor.
    - `hasMore` boolean, required — Indica se existe mais itens para carregar.
    - `next` string, nullable, required — Cursor para próxima página (usar em after).
    - `before` string, nullable, required — Cursor para página anterior (usar em before).

## Other responses

- `401` — Não autorizado. Falha na autenticação.

---

[API](https://skmtc.net/abacatepay/apis/api-abacatepay.md) · [All operations](https://skmtc.net/abacatepay/apis/api-abacatepay/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/abacatepay/api-abacatepay/revisions/6b89a7fa70f5/schema)