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

```
v1/customers/get_list.php
```

## Параметры

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

Без limit возвращается весь список. Подробнее о постраничной выдаче в статье [Общие правила](https://developers.controlata.ru/hc/api-docs/articles/rules).

## Ответ

Массив customers со всеми полями покупателя (см. [Покупатели](https://developers.controlata.ru/hc/api-docs/articles/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 |