Возвращает поставки компании, от новых к старым по дате заказа поставки. Строки поставок в список не входят, их возвращает [v1/purchases/get_entry](https://developers.controlata.ru/hc/api-docs/articles/purchases-get-entry).

```
v1/purchases/get_list.php
```

## Параметры

| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| date_from | string | Нет | Поставки с этой даты заказа включительно |
| date_to | string | Нет | Поставки по эту дату заказа включительно |
| supplier_id | int | Нет | Только поставки этого поставщика |
| limit | int | Нет | Размер страницы, от 1 до 1000 |
| offset | int | Нет | Сколько записей пропустить |

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

## Ответ

Массив purchases с полями поставки (см. [Поставки](https://developers.controlata.ru/hc/api-docs/articles/purchases)). Поле total в корне ответа содержит общее число поставок, подходящих под фильтры.

## Пример запроса

```
{
    "date_from": "2026-10-01",
    "supplier_id": 45,
    "limit": 100,
    "offset": 0
}
```

## Пример ответа

```
{
    "success": true,
    "purchases": [
        {
            "id": "29645",
            "status": "1",
            "payment": "0",
            "date_placed": "2026-10-06",
            "date_received": "",
            "supplier_id": "45",
            "supplier_name": "ООО Лесторг",
            "materials_storage_id": "3998",
            "materials_storage_name": "Основной склад",
            "products_storage_id": "3998",
            "products_storage_name": "Основной склад",
            "subtotal": "30000.00",
            "delivery_price": "1500.00",
            "discount": "0.00",
            "total": "31500.00",
            "amount": null,
            "lines": "2",
            "shipments_count": "0",
            "notes": "Счет № 118"
        }
    ],
    "total": 1
}
```

## Ошибки

| Ошибка | Причина |
|---|---|
| Date is not a valid date in format YYYY-MM-DD | Неверная date_from или date_to |
| Invalid limit value. Must be between 1 and 1000 | Неверный limit |
| Invalid offset value. Must be 0 or greater | Неверный offset |
| Offset requires limit | Передан offset без limit |