---
title: "List the customers"
method: GET
path: "/customer"
tags: ["customer"]
---

# List the customers

`GET /customer`

## Query parameters

- `country` string — ISO-3166-1 Alfa-2 country code
- `tax_id` string
- `tax_id_type` 'rfc' | 'cnpj' | 'cpf' | 'ruc' | 'curp' | 'le' | 'dni' | 'lm' | 'pas' | 'ce' | 'nit' | 'cc' | 'pa' | 'ti' | 'nuip' | 'ppt' | 'pep' | 'cuil' | 'cuit' | 'other'
- `external_id` string

## Response `200`

Customer listed

- object
  - `count` integer — The number of customers listed
  - `next` string, uri — The next page of listed customers
  - `previous` string, uri — The previous page of listed customers
  - `results` CustomerResponse[] — The list of customers
    - `name` string, required
    - `document_type` string, nullable
    - `document_number` string, nullable
    - `email` string, email, nullable
    - `id` string, uuid, required

## Other responses

- `400` — Bad Request - Invalid input or malformed data
- `401` — Unauthorized access due to missing or invalid API key
- `403` — Permission denied for the requested action.
- `404` — The requested resource does not exist.
- `405` — The HTTP method used is not allowed for this endpoint.
- `406` — The Accept header cannot be satisfied.
- `415` — The request's content type is not supported.
- `429` — Too many requests, the request has been throttled.
- `500` — A generic internal API error occurred.

---

[API](https://skmtc.net/prometeoapi/apis/account-validation-v2.md) · [All operations](https://skmtc.net/prometeoapi/apis/account-validation-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prometeoapi/account-validation-v2/revisions/9c278fe91cbd/schema)