Возвращает покупателей компании, отсортированных по имени. Удаленные покупатели в список не входят.
v1/customers/get_list.php
Параметры
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| limit | int | Нет | Размер страницы, от 1 до 1000 |
| offset | int | Нет | Сколько записей пропустить |
Без limit возвращается весь список. Подробнее о постраничной выдаче в статье Общие правила.
Ответ
Массив customers со всеми полями покупателя (см. Покупатели). Поле total содержит общее число покупателей.
Пример запроса
{
"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 |