# Пагинация

> Как устроены списки в API LegalStack.

Единого конверта пагинации в API нет — смотрите схему ответа конкретной операции в [справочнике API](https://docs.legalstack.ru/api).

Два типовых случая:

## Плоские списки

Большинство списочных операций (например, `GET /api/v1/tasks`) возвращают массив целиком; объём ограничен областью видимости команды и фильтрами запроса:

Запрос:

```http
GET /api/v1/tasks?status=inProgress HTTP/1.1
```

Ответ:

```json
[{ "id": "8d2c0e7a-5b1f-4c3e-9a6d-2f4b7c1e9a30", "title": "Проверить договор" }]
```

## Пагинация с курсором

Журнальные данные отдаются страницами с курсором — например, журнал аудита безопасности:

Запрос:

```http
GET /api/v1/security/audit/me?limit=50 HTTP/1.1
```

Ответ:

```json
{ "events": [...], "nextCursor": "eyJpZCI6..." }
```

Передавайте `nextCursor` в параметре `cursor` следующего запроса; значение `null` означает конец выборки. Точные имена полей конверта указаны в схеме каждой операции.