---
title: "Listar Clientes"
method: GET
path: "/customers"
---

# Listar Clientes

`GET /customers`

Retorna uma lista com os clientes cadastrados em sua conta, ordenados pela data de criação, do mais recente para o mais antigo. O campo totalItems indica a quantidade de registros retornados nesta página (igual ao tamanho de items ). Para detectar o fim da listagem, compare items.length com limit : se for menor, não há mais páginas.

## Query parameters

- `limit` integer
- `start` integer
- `created_at_from` string, date
- `created_at_to` string, date
- `query` string
- `updated_since` string, date
- `updated_until` string, date

## Response `200`

200

- object
  - `items` object[]
    - `id` string
    - `email` string
    - `name` string
    - `notes` string
    - `created_at` string
    - `updated_at` string
    - `cc_emails` unknown
    - `cpf_cnpj` string
    - `zip_code` string
    - `number` string
    - `complement` string
    - `phone` string
    - `phone_prefix` string
    - `custom_variables` object[]
      - `name` string
      - `value` string
    - `payment_methods` object[]
    - `default_payment_method_id` unknown
    - `proxy_payments_from_customer_id` unknown
    - `city` string
    - `state` string
    - `district` string
    - `street` string
  - `totalItems` integer

## Other responses

- `400` — 400

---

[API](https://skmtc.net/iugu/apis/tokens-de-api.md) · [All operations](https://skmtc.net/iugu/apis/tokens-de-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iugu/tokens-de-api/versions/4590fc729d1e/schema)