Получение списка покупателей

Максим

Максим

Обновлено Oct 7, 2026

Возвращает покупателей компании, отсортированных по имени. Удаленные покупатели в список не входят.

v1/customers/get_list.php

Параметры

Поле Тип Обязательное Описание
limit int Нет Размер страницы, от 1 до 1000
offset int Нет Сколько записей пропустить

Без limit возвращается весь список. Подробнее о постраничной выдаче в статье Общие правила.

Ответ

Массив customers с полями покупателя. Поле total содержит общее число покупателей.

Поле Тип Описание
id int ID покупателя
type int Тип покупателя: 1 юрлицо, 2 ИП, 3 физлицо
name string Наименование юрлица или имя ИП и физлица
email 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