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

# List Customers

`GET /v2/customers/`

## Query parameters

- `created` string, date-time
- `external_id` string
- `email` string
- `name` string
- `country` string
- `legal_id` string
- `start` integer
- `limit` integer

## Response `200`

Successful Response

- CustomerOutList
  - `range` ResponseRange, required
    - `start` integer, required
    - `end` integer, required
    - `limit` integer, required
    - `count` integer, required
    - `has_more` boolean, required
  - `customers` CustomerOut[], required
    - `id` string, required
    - `country` string — Country of the card issuer
    - `created` string, date-time, required — Unique id with unicity check
    - `date_birth` string, date — Date of birth
    - `email` string — Customer email
    - `external_id` string — Unique id with unicity check
    - `legal_id` string — Any legal identifier like SIREN, CBE, KVK, etc
    - `mobile` string — Customer email
    - `name` string — Customer name
    - `billing_address` string — Billing address
    - `shipping_address` string — Shipping address
    - `deleted` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/stancer/apis/stancer-api.md) · [All operations](https://skmtc.dev/stancer/apis/stancer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stancer/stancer-api/revisions/c637e4c7ff04/schema)