Возвращает покупателей компании, отсортированных по имени. Удаленные покупатели в список не входят.
v1/customers/get_list.php
Параметры
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| limit | int | Нет | Размер страницы, от 1 до 1000 |
| offset | int | Нет | Сколько записей пропустить |
Без limit возвращается весь список. Подробнее о постраничной выдаче в статье Общие правила.
Ответ
Массив customers с полями покупателя. Поле total содержит общее число покупателей.
| Поле | Тип | Описание |
|---|---|---|
| id | int | ID покупателя |
| type | int | Тип покупателя: 1 юрлицо, 2 ИП, 3 физлицо |
| name | string | Наименование юрлица или имя ИП и физлица |
| string | Электронная почта | |
| phone | string | Телефон |
| address_legal | string | Юридический адрес |
| address_real | string | Адрес доставки |
| inn | string | ИНН |
| kpp | string | КПП |
| ogrn | string | ОГРН |
| agreement | string | Договор |
| manager_name | string | Руководитель |
| manager_post | string | Должность руководителя |
| notes | string | Заметки |
Пример запроса
{
"limit": 100,
"offset": 0
}
Пример ответа
{
"success": true,
"customers": [
{
"id": 513,
"type": 3,
"name": "Анна Смирнова",
"email": "anna@example.com",
"phone": "+7 916 555-12-34",
"address_legal": "",
"address_real": "г. Казань, ул. Баумана, д. 20, кв. 7",
"inn": "",
"kpp": "",
"ogrn": "",
"agreement": "",
"manager_name": "",
"manager_post": "",
"notes": ""
},
{
"id": 512,
"type": 1,
"name": "ООО Мебельный двор",
"email": "zakaz@mebdvor.ru",
"phone": "+7 495 123-45-67",
"address_legal": "г. Москва, ул. Лесная, д. 5",
"address_real": "г. Москва, ул. Складская, д. 12",
"inn": "7701234567",
"kpp": "770101001",
"ogrn": "1027700123456",
"agreement": "№ 15 от 10.01.2026",
"manager_name": "Иванов Петр Сергеевич",
"manager_post": "Генеральный директор",
"notes": ""
}
],
"total": 2
}
Ошибки
| Ошибка | Причина |
|---|---|
| Invalid limit value. Must be between 1 and 1000 | Неверный limit |
| Invalid offset value. Must be 0 or greater | Неверный offset |
| Offset requires limit | Передан offset без limit |