---
title: "Список клиентов"
method: GET
path: "/clients"
tags: ["Клиенты"]
---

# Список клиентов

`GET /clients`

Возвращает постраничный список клиентов.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Список клиентов.

- object
  - `clients` Client[], required — Список клиентов.
    - `id` string, required — Цифровой идентификатор клиента, отформатированный строкой.
    - `guid` string, uuid, required — UUID в стандартном строковом формате.
    - `dealer_id` string, required — Цифровой идентификатор дилера, отформатированный строкой.
    - `registred` string, required — Дата и время в формате ISO 8601 UTC.
    - `electronic` string, required — Баланс электронного лицевого счета.
    - `cashless` string, required — Баланс безналичного лицевого счета.
    - `name` string, required — Отображаемое имя клиента.
    - `email` string, email, required — Контактный email клиента.
    - `phone` string, required — Контактный телефон клиента.
    - `timezone` string, required — Часовой пояс клиента.
    - `inn` string, required — ИНН клиента.
    - `kpp` string, required — КПП клиента.
    - `is_individual` boolean, required — Клиент является индивидуальным предпринимателем или физлицом.
    - `is_foreign` boolean, required — Клиент является иностранным.
    - `is_active` boolean, required — Клиент активен.
    - `is_negative_balance` boolean, required — У клиента отрицательный общий баланс.
    - `available_balance` string, required — Доступный баланс клиента.
    - `total_balance` string, required — Общий баланс клиента.
  - `next` integer — Номер следующей страницы, если есть продолжение списка.

## Other responses

- `400` — Неправильный запрос.
- `401` — Пользователь не авторизован или токен не передан.
- `403` — Доступ запрещен.
- `500` — Внутренняя ошибка сервера.

---

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