> ## Documentation Index
> Fetch the complete documentation index at: https://platform.doodocs.kz/llms.txt
> Use this file to discover all available pages before exploring further.

# Пагинация

> Постраничный обход списков через page_token

Списковые ручки возвращают результаты страницами. Управление — параметрами
`limit` и `page_token`.

## Как это работает

```bash theme={null}
curl -H "X-API-Key: ddp_ВАШ_КЛЮЧ" \
  "https://app.doodocs.kz/api/developer/v1/employees?limit=100"
```

```json theme={null}
{
  "employees": [ "…" ],
  "next_page_token": "CgYIyAE.7f3a"
}
```

Передайте `next_page_token` в следующий запрос, чтобы получить следующую страницу.
Пустой `next_page_token` означает, что страниц больше нет.

```bash theme={null}
curl -H "X-API-Key: ddp_ВАШ_КЛЮЧ" \
  "https://app.doodocs.kz/api/developer/v1/employees?limit=100&page_token=CgYIyAE.7f3a"
```

* `limit` — по умолчанию `100`, максимум `1000`.
* `page_token` — непрозрачный. Не разбирайте и не конструируйте его; передавайте
  ровно то значение, что получили.

<Warning>
  Токен привязан к набору фильтров, для которого был выдан. Если передать его в
  запрос с другими `status`, `department_id`, `updated_since` или `limit`, ответ
  будет `INVALID_ARGUMENT`. Меняете фильтры — начинайте обход заново без токена.
</Warning>

## Общее число

По умолчанию число всех подходящих записей не считается. Запросите его явно через
`include_total=true`:

```bash theme={null}
curl -H "X-API-Key: ddp_ВАШ_КЛЮЧ" \
  "https://app.doodocs.kz/api/developer/v1/employees?limit=100&include_total=true"
```

Поле `total_count` появляется в ответе. На больших выборках (свыше \~10 000 записей)
это оценка планировщика, а не точное число.

## Инкрементальная синхронизация

Чтобы забирать только изменения, фильтруйте по `updated_since` (RFC 3339):

```bash theme={null}
curl -H "X-API-Key: ddp_ВАШ_КЛЮЧ" \
  "https://app.doodocs.kz/api/developer/v1/employees?updated_since=2026-02-01T00:00:00Z"
```

<Note>
  `updated_since` отражает изменения самой карточки сотрудника. Переименование
  связанных сущностей (человек, отдел) в это поле **не** попадает — для них
  используйте [вебхуки](/ru/api-reference/webhooks): переименование человека приходит
  как `employee.changed`. Для сверки удалений периодически делайте полный перечит.

  Смещение часового пояса в query кодируйте как `%2B05:00` или присылайте время в
  `Z` (UTC): «плюс» в URL иначе трактуется как пробел.
</Note>