# Список заданий

`GET /v1/bizproc-tasks`

Одна страница заданий Битрикс24. Обычный пользователь по умолчанию видит свои задания. Администратор без фильтра может увидеть задания всех пользователей: для своих укажите `filter={"userId":1373}`. Права руководителя и администратора проверяет Битрикс24.

Bitrix24 API: `bizproc.task.list`
Скоуп: `bizproc`

## Параметры

| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
| `select` | string | Нет | Поля через запятую: camelCase или имена Битрикс24. По умолчанию ID, WORKFLOW_ID, DOCUMENT_NAME, NAME |
| `filter` | string | Нет | JSON-объект. Префиксы =, !, !=, <, <=, >, >=. Значения — скаляры или непустые массивы скаляров |
| `order` | string | Нет | JSON-объект: имя поля и ASC или DESC. По умолчанию ID DESC |
| `start` | integer | Нет | Неотрицательная позиция страницы Битрикс24, по умолчанию 0. Следующая — meta.next |

## Поля ответа

| Поле | Тип | Описание |
|---|---|---|
| `success` | boolean | true |
| `data` | object[] | Задания. Имена полей в camelCase, типы значений Битрикс24 сохранены |
| `meta.start` | integer | Запрошенная позиция страницы |
| `meta.total` | integer | Количество из ответа Битрикс24. Отсутствует, если не вернулось |
| `meta.next` | integer | Следующая позиция из Битрикс24. Отсутствует на последней странице |

Доступные поля: `id`, `activity`, `activityName`, `workflowId`, `documentName`, `description`, `name`, `modified`, `workflowStarted`, `workflowStartedBy`, `overdueDate`, `workflowTemplateId`, `workflowTemplateName`, `workflowState`, `status`, `userId`, `userStatus`, `moduleId`, `entity`, `documentId`, `parameters`, `documentUrl`. `parameters` описывает форму задания. Значения кодов полей сохранены. URL с секретами заменены на `[REDACTED]`.

## Примеры

### cURL API key

```bash
curl -X GET "https://vibecode.bitrix24.tech/v1/bizproc-tasks" \
  -H "X-Api-Key: YOUR_API_KEY"
```

### cURL OAuth

```bash
curl -X GET "https://vibecode.bitrix24.tech/v1/bizproc-tasks" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN"
```

### JavaScript API key

```javascript
const response = await fetch("https://vibecode.bitrix24.tech/v1/bizproc-tasks", {
  method: "GET",
  headers: { "X-Api-Key": "YOUR_API_KEY" }
});
console.log(await response.json());
```

### JavaScript OAuth

```javascript
const response = await fetch("https://vibecode.bitrix24.tech/v1/bizproc-tasks", {
  method: "GET",
  headers: { "X-Api-Key": "YOUR_APP_KEY", "Authorization": "Bearer YOUR_SESSION_TOKEN" }
});
console.log(await response.json());
```

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

Пустой список на тестовом аккаунте.

```json
{"success":true,"data":[],"meta":{"start":0,"total":0}}
```

Неверные параметры отклоняются до вызова Битрикс24:

```json
{"success":false,"error":{"code":"INVALID_PARAMS","message":"Invalid request parameters"}}
```

## Ошибки

| HTTP | Code | Условие |
|---|---|---|
| 400 | `INVALID_PARAMS` | Неверные или отсутствующие параметры |
| 401 | `TOKEN_MISSING` | Нет реквизитов авторизации Битрикс24 |
| 403 | `SCOPE_DENIED` | Нет скоупа bizproc |
| 403 | `BITRIX_ACCESS_DENIED` | Битрикс24 отказал в доступе |
| 422 | `BITRIX_ERROR` | Бизнес-отказ Битрикс24. Текст сохранён с удалением секретов |
| 502 | `BITRIX_RESPONSE_INVALID` | Неожиданная форма ответа или результат действия |

Общие отказы и лимиты: [Ошибки API](/docs/errors).

## Смотрите также

- [Задания бизнес-процессов](/docs/automation/bizproc-tasks)
- [Экземпляры процессов](/docs/automation/workflows)