---
title: "List customers"
method: GET
path: "/customers"
---

# List customers

`GET /customers`

This endpoint returns customers that match the requirements given in the API request. For example, it allows you to filter customers based on `externalId` or `email`.<br><br>The recommended limit for checking if a user is registered using an email address is: 1.

## Query parameters

- `offset` integer, required
- `limit` integer, required
- `externalId` string
- `email` string

## Headers

- `Content-Type` string

## Response `200`

200

- object
  - `success` boolean
  - `data` object[]
    - `id` integer
    - `email` string
    - `country` string
    - `regDate` string
    - `lastLoginDate` string
    - `lastUserIp` string
    - `currency` string
    - `locale` string
    - `externalId` string
    - `externalData` object
      - `data` string
  - `message` string

## Other responses

- `422` — Unprocessable Entity

---

[API](https://skmtc.net/cleeng/apis/mediastore-api.md) · [All operations](https://skmtc.net/cleeng/apis/mediastore-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cleeng/mediastore-api/versions/00cbfe7998a4/schema)