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

```
v1/audits/get_list.php
```

## Параметры

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

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

## Ответ

Массив audits с полями инвентаризации (см. [Инвентаризации](https://developers.controlata.ru/hc/api-docs/articles/audits)), без строк. Строки и тип инвентаризации возвращает [v1/audits/get_entry](https://developers.controlata.ru/hc/api-docs/articles/audits-get-entry). Поле total содержит общее число инвентаризаций, подходящих под фильтры.

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

```
{
    "storage_id": 3998,
    "date_from": "2026-01-01",
    "limit": 100,
    "offset": 0
}
```

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

```
{
    "success": true,
    "audits": [
        {
            "id": "1699",
            "num": "24",
            "date": "2026-09-30",
            "status": "1",
            "storage_id": "3998",
            "storage_name": "Главный",
            "lines": "2",
            "surplus_cost": "0.00",
            "shortage_cost": "-57900.00",
            "total_cost": "-57900.00",
            "surplus_price": "0.00",
            "shortage_price": "0.00",
            "total_price": "0.00"
        }
    ],
    "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 |
| Offset requires limit | Передан offset без limit |