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

# List customers

`GET /customers`

Lists the customers of your organization for the `live` or `test` mode of the API key used. Customers are returned sorted by creation date, with the most recently created customers appearing first. Use `limit` together with the `starting_after` and `ending_before` cursors to paginate the results. The `Link` response header contains the URL of the next page when more results are available.

## Query parameters

- `ending_before` string
- `limit` integer
- `starting_after` string
- `tax_id` string
- `tax_id_type` 'cl_rut' | 'mx_rfc'

## Response `200`

List of customers for the current mode, sorted by creation date (most recent first).

- Customer[]
  - `id` string, required — Unique identifier of the customer.
  - `object` 'customer', required — Type of the object. Always `customer`.
  - `address` object, nullable, required — Customer's address. Only the fields with a value are returned. `null` when the customer has no address information.
    - `city` string — City.
    - `country` string — Two-letter country code (ISO 3166-1 alpha-2), in lowercase.
    - `line1` string — Primary address line.
    - `line2` string — Secondary address line.
    - `postal_code` string — Postal or ZIP code.
    - `state` string — State or region.
  - `created_at` string, date-time, required — ISO 8601 datetime, in UTC, of when the customer was created.
  - `email` string, nullable, required — Customer's email, stored in lowercase. `null` if not provided.
  - `metadata` object, required — Set of key-value pairs that you can attach to an object. Useful for storing additional information about the object in a structured format.
  - `mode` 'live' | 'test', required — Mode of the customer, matching the mode of the API key used to create it. One of `live` or `test`.
  - `name` string, nullable, required — Customer's full name or business name. `null` if not provided.
  - `phone` string, nullable, required — Customer's phone number in E.164 format, including the country code (for example `+56911111111`). `null` if not provided.
  - `tax_id` object, nullable, required — Tax identifier of the customer (Chilean RUT or Mexican RFC). `null` if not provided.
    - `type` 'cl_rut' | 'mx_rfc', required — Type of tax identifier. One of `cl_rut` (Chilean RUT) or `mx_rfc` (Mexican RFC).
    - `value` string, required — Value of the tax identifier, normalized. RUTs are stored without dots or hyphens, and RFCs are stored in uppercase.

## Other responses

- `400` — Invalid request. Returned when `starting_after` and `ending_before` are used together, or when `tax_id_type` is unsupported.
- `401` — Invalid or missing API key.
- `404` — The customer used as pagination cursor does not exist.

---

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