---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.2
  - property: og:type
    content: article
  - property: article:section
    content: Справочник API
  - property: og:title
    content: Найти задачи
  - property: article:tag
    content: Техническая инструкция
alternate:
  - https://yandex.ru/support/tracker/en/api-ref/issues/search-issues.md
  - https://yandex.ru/support/tracker/ru/api-ref/issues/search-issues.md
  - href: ru/api-ref/issues/search-issues.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/tracker/ru/llms.txt


# Найти задачи

Запрос позволяет получить список задач, удовлетворяющих заданному критерию.

<div class="request_example method_post yfm-clipboard">
    <p>POST</p>
    <pre><code>https://api.tracker.yandex.net/v3/issues/_search?expand=transitions</code></pre>
    <button class="yfm-clipboard-button"><svg width="16" height="16" viewBox="0 0 24 24" class="yfm-clipboard-icon" data-animation="15">
    <path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path>
    <path stroke="currentColor" fill="transparent" strokewidth="1.5" d="M9.5 13l3 3l5 -5" visibility="hidden">
        <animate id="visibileAnimation-15" attributeName="visibility" from="hidden" to="visible" dur="0.2s" fill="freeze" begin=""></animate>
        <animate id="hideAnimation-15" attributeName="visibility" from="visible" to="hidden" dur="1s" begin="visibileAnimation-15.end+1" fill="freeze"></animate>
    </path>
</svg>
</button>
</div>

<!-- source: ru/api-ref/_assets/style/methods.md -->

<!-- endsource: ru/api-ref/_assets/style/methods.md -->

Для отображения результатов поиска доступны три варианта:

1. **[Постраничное отображение](#pagination)** — для запросов с параметрами `filter`, `query` или `keys` при количестве результатов менее 10000.
2. **[Относительная пагинация](#relative-pagination)** — для запросов с параметром `queue`.
3. **[Механизм прокрутки](#scroll)** — для запросов с большим количеством результатов (более 10000).

## Формат запроса {#query}

Перед выполнением запроса [получите доступ к API](https://yandex.ru/support/tracker/ru/api-ref/access.md).

Для поиска задач используйте HTTP-запрос с методом `POST`. Тело запроса содержит критерии для поиска.

```json
POST /v3/issues/_search?expand=transitions
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
Content-Type: application/json
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

{
   "filter": {
      "<имя_поля>": "<значение_в_поле>"
   },
   "order":"+<ключ_поля>"
}
```

<!-- source: ru/api-ref/_includes/headings.md -->
{% cut "Заголовки" %}

* `Host`: адрес узла, предоставляющего API.

* <!-- source: ru/api-ref/_includes/authorization.md -->
  `Authorization`: токен для авторизации в одном из форматов:

    - `OAuth <OAuth-токен>` при авторизации по протоколу OAuth 2.0. [Читать подробнее](https://yandex.ru/support/tracker/ru/api-ref/access.md#about_OAuth)

    - `Bearer <IAM-токен>` при авторизации с помощью IAM-токена — если к Трекеру привязана организация Yandex Identity Hub. [Читать подробнее](https://yandex.ru/support/tracker/ru/api-ref/access.md#iam-token)
  <!-- endsource: ru/api-ref/_includes/authorization.md -->

* <!-- source: ru/api-ref/_includes/content-type-json.md -->
  `Content-Type`: формат тела запроса. Должен иметь значение `application/json`.
  <!-- endsource: ru/api-ref/_includes/content-type-json.md -->


* <!-- source: ru/api-ref/_includes/org-id.md -->
  `X-Org-ID` или `X-Cloud-Org-ID`: идентификатор организации.

  - если к Трекеру привязана организация Яндекс 360 для бизнеса, используйте заголовок `X-Org-ID`,

  - если к Трекеру привязана организация Yandex Identity Hub, используйте заголовок `X-Cloud-Org-ID`.
  <!-- endsource: ru/api-ref/_includes/org-id.md -->

  <!-- source: ru/api-ref/_includes/org-id.md -->
  Чтобы узнать идентификатор организации, перейдите на страницу **Администрирование** → [**Организации**](https://tracker.yandex.ru/admin/orgs) и скопируйте значение поля **идентификатор**.
  <!-- endsource: ru/api-ref/_includes/org-id.md -->


{% endcut %}
<!-- endsource: ru/api-ref/_includes/headings.md -->

{% cut "Параметры запроса" %}

**Дополнительные параметры**

#|
|| **Параметр** | **Описание** | **Тип данных** ||
|| fields | Поля задачи, которые будут включены в ответ. Можно указать несколько полей через запятую. Полный список поддерживаемых параметров можно найти на странице [https://tracker.yandex.ru/admin/fields](https://tracker.yandex.ru/admin/fields). | Строка ||
|| expand | Дополнительные поля, которые будут включены в ответ:
- `transitions` — переходы по жизненному циклу;
- `attachments` — вложения;
- `comments` — комментарии. | Строка ||
|| perPage | Количество задач на странице ответа. Значение по умолчанию — 50. При использовании параметра `queue` поддерживается только [относительная пагинация](#relative-pagination). Для других параметров (`filter`, `query`, `keys`) используется [постраничное отображение](#pagination). | Число ||
|| page | Номер страницы ответа при [постраничном отображении](#pagination). | Число ||
|| id  | Идентификатор страницы ответа при [относительной пагинации](#relative-pagination). | Число ||
||
scrollType
perScroll
scrollTTLMillis
scrollId | Параметры отображения ответа при использовании [механизма прокрутки](#scroll). |
Строка
Число
Число
Число
||
|#

{% endcut %}

{% cut "Параметры тела запроса" %}

Для получения списка задач, укажите один из следующих параметров:

Параметр | Описание | Формат
----- | ----- | -----
queue | Очередь. | Строка
keys | Список ключей задач. | Строка или Массив строк
filter | Параметры фильтрации задач. В параметре можно указать название любого поля и значение, по которому будет производиться фильтрация. [Полный список полей задачи](https://tracker.yandex.ru/admin/fields) | Объект
filterId | Идентификатор [сохраненного фильтра](*filter). | Число
query | Фильтр на [языке запросов](https://yandex.ru/support/tracker/user/query-filter.html). | Строка

{% note info "" %}

Запрос не подразумевает комбинирование параметров.

При использовании комбинации двух параметров, в ответе будет возвращен результат по параметру с более высоким приоритетом.
Приоритеты параметров (в порядке убывания):
1. `queue`;
2. `keys`;
3. `filter`;
4. `query`.

При использовании комбинации трех или четырех параметров, ответ будет содержать код 400 с сообщением `Вы можете использовать только ключи, очередь или поисковый запрос.`

{% endnote %}

**Дополнительные параметры**

Параметр | Описание | Формат
----- | ----- | -----
order | Направление и поле сортировки задач (только в комбинации с параметром `filter`). <br/>Значение указывается в формате `[+/-]<ключ_поля>`. Знак `+` или `-` обозначает направление сортировки. | Строка

{% note info "" %}

При использовании параметра `query` указывайте способ сортировки с помощью [языка запросов](https://yandex.ru/support/tracker/user/query-filter.html).
Ответ на запрос с параметром `queue` сортируется по ключу задачи, а с параметром `keys` — по названиям задач в алфавитном порядке.

{% endnote %}

{% endcut %}

> Пример 1: Запрос списка задач с помощью фильтра:
>
> - Используется HTTP-метод POST.
> - В ответе включено отображение вложений.
> - Ответ должен содержать только задачи из очереди «TREK», в которых не указан исполнитель.
> - Результаты отсортированы по статусу в возрастающем порядке.
>
> ```json translate=no
> POST /v3/issues/_search?expand=attachments HTTP/1.1
> Host: api.tracker.yandex.net
> Authorization: OAuth y0__xAbc******
> Content-Type: application/json
> X-Org-ID: 1234******
>
> {
>   "filter": {
>     "queue": "TREK",
>     "assignee": "empty()"
>   },
>   "order":"+status"
> }
> ```

> Пример 2: Запрос списка задач с помощью языка запросов:
>
> - Используется HTTP-метод POST.
> - Ответ должен содержать только задачи из очереди «TREK», которые не являются эпиками.
> - Результаты отсортированы по дате обновления в убывающем порядке.
> - В ответе отобразятся комментарии к задаче.
>
> ```json translate=no
> POST /v3/issues/_search?expand=comments HTTP/1.1
> Host: api.tracker.yandex.net
> Authorization: OAuth y0__xAbc******
> Content-Type: application/json
> X-Cloud-Org-ID: ab1c******
>
> {
>   "query": "epic: notEmpty() Queue: TREK \"Sort by\": Updated DESC"
> }
> ```

> Пример 3: Запрос списка задач с указанием полей для отображения:
>
> - Используется HTTP-метод POST.
> - В параметре запроса `fields` указаны поля, которые будут включены в ответ.
>
> ```json translate=no
> POST /v3/issues/_search?fields=summary,status,assignee,updatedAt HTTP/1.1
> Host: api.tracker.yandex.net
> Authorization: OAuth y0__xAbc******
> X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
> ```

## Формат ответа {#answer}

{% list tabs %}

- Запрос выполнен успешно

    <!-- source: ru/api-ref/_includes/answer-200.md -->
    В случае успешного выполнения запроса API возвращает ответ с кодом `200 OK`.
    <!-- endsource: ru/api-ref/_includes/answer-200.md -->

    Тело ответа содержит результаты в формате JSON.

    {% include [answer-issue](../_includes/answer-issue.md) %}

- Запрос выполнен с ошибкой

    Если запрос не был успешно обработан, API возвращает ответ с кодом ошибки:

    <!-- source: ru/api-ref/_includes/answer-error-400.md -->
    400
    :   Один или несколько параметров запроса имеют недопустимое значение.
    <!-- endsource: ru/api-ref/_includes/answer-error-400.md -->

    <!-- source: ru/api-ref/_includes/answer-error-401.md -->
    401
    :   Пользователь не авторизован. Проверьте, были ли выполнены действия, описанные в разделе [Доступ к API](https://yandex.ru/support/tracker/ru/api-ref/access.md).
    <!-- endsource: ru/api-ref/_includes/answer-error-401.md -->

    <!-- source: ru/api-ref/_includes/answer-error-403.md -->
    403
    :   У вас не хватает прав на выполнение этого действия. Наличие прав можно перепроверить в интерфейсе Трекера — для выполнения действия при помощи API и через интерфейс требуются одинаковые права.
    <!-- endsource: ru/api-ref/_includes/answer-error-403.md -->

    <!-- source: ru/api-ref/_includes/answer-error-404.md -->
    404
    :   Запрошенный объект не был найден. Возможно, вы указали неверное значение идентификатора или ключа объекта.
    <!-- endsource: ru/api-ref/_includes/answer-error-404.md -->

{% endlist %}

## Постраничное отображение результатов {#pagination}

Постраничное отображение используется для запросов с параметрами `filter`, `query` или `keys` при количестве результатов менее 10000.

При постраничном отображении результаты запроса рассчитываются каждый раз при отображении новой страницы. Если за время просмотра одной страницы в результатах запроса произошли изменения, это может повлиять на отображение следующих страниц.

### Параметры запроса

Для постраничного отображения результатов используйте следующие параметры:

- **perPage (необязательный)**

    Количество задач на странице ответа. Значение по умолчанию — 50.

- **page (необязательный)**

    Номер страницы ответа. Значение по умолчанию — 1.

### Заголовки ответа

В ответе будут содержаться следующие заголовки:

- **X-Total-Pages**

    Общее количество страниц с записями.

- **X-Total-Count**

    Общее число записей в ответе.

### Пример запроса с постраничным отображением

Найти задачи с помощью фильтра и отобразить результаты постранично:

```json translate=no
POST /v3/issues/_search?perPage=10&page=2
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

{
  "filter": {
    "assignee": "<user_login>",
    "status": "open"
  }
}
```

## Относительная пагинация {#relative-pagination}

Для запросов с параметром `queue` используется относительная пагинация, постраничное отображение с параметром `page` не поддерживается.

При использовании относительной пагинации следующая страница определяется через заголовок `Link` в ответе.

### Параметры запроса

- **perPage (необязательный)**

    Количество задач на странице ответа. Значение по умолчанию — 50.

- **id (необязательный)**

    Идентификатор страницы из заголовка `Link`.

### Заголовки ответа

В ответе содержится заголовок:

- **Link**

    Ссылка для перехода на следующую страницу результатов поиска. Содержит параметр `id` для получения следующей страницы.

### Пример запроса с относительной пагинацией

1. Первый запрос для получения задач очереди:

    ```json translate=no
    POST /v3/issues/_search?perPage=10
    Host: api.tracker.yandex.net
    Authorization: OAuth <OAuth-токен>
    X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

    {
      "queue": "TREK"
    }
    ```

    В заголовке `Link` ответа будет содержаться ссылка для получения следующей страницы:

    ```
    Link: <api.tracker.yandex.net/v3/issues/_search?id=5f2ad1314033c53616b50cd9&perPage=10>; rel="next"
    ```

2. Запрос следующей страницы с использованием параметра `id` из заголовка `Link`:

    ```json translate=no
    POST /v3/issues/_search?id=5f2ad1314033c53616b50cd9&perPage=10
    Host: api.tracker.yandex.net
    Authorization: OAuth <OAuth-токен>
    X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

    {
      "queue": "TREK"
    }
    ```

## Прокрутка результатов поиска {#scroll}

Если ответ на запрос поиска задач содержит более 10000 строк, рекомендуем использовать механизм прокрутки результатов.

При использовании механизма прокрутки в ответ на запрос возвращается страница с результатами поиска и идентификатором для получения следующей страницы.

Результаты поиска можно отобразить в отсортированном виде или в произвольном порядке. Чтобы уменьшить количество затрачиваемых ресурсов при поиске большого количества задач, используйте механизм прокрутки без сортировки.

{% note info "" %}

Прокрутка результатов поиска требует больше ресурсов по сравнению с [постраничным отображением результатов](https://yandex.ru/support/tracker/ru/api-ref/common-format.md#displaying-results).

{% endnote %}

### Параметры запроса с прокруткой {#scroll-params}

- **scrollType**

    Тип прокрутки. Допустимые значения:

    - `sorted` — используется указанная в запросе сортировка;
    - `unsorted` — сортировка не используется.

    Данный параметр используется только в первом из серии запросов прокрутки.

    Данный параметр не используется совместно с параметрами поиска `keys` или `queue`. При использовании прокрутки и этих параметров ответ будет содержать код 400 и сообщение `Прокрутка результатов не поддерживается`. Чтобы найти задачи очереди, используйте параметры `filter` или `query`.

- **perScroll**

    Максимальное количество задач в ответе. Значение по умолчанию — 100, максимально допустимое значение — 1000.

    Данный параметр используется только в первом из серии запросов прокрутки.

- **scrollTTLMillis (необязательный параметр)**

    Время жизни контекста прокрутки в миллисекундах. Значение по умолчанию — 60000.

- **scrollId**

    Идентификатор страницы.

    Данный параметр указывается во втором и следующих запросах серии прокрутки. Значение параметра должно быть получено из заголовка `X-Scroll-Id`, который возвращается в ответе на предыдущий запрос серии.


### Ответ на запрос с прокруткой {#scroll-response}

При использовании прокрутки создается слепок результатов поиска. Страницы результатов переключаются в рамках этого слепка. Если задача будет изменена и перестанет отвечать требованиям поискового запроса, это не повлияет на ее отображение в слепке результатов поиска.

Слепок результатов поиска сохраняется, пока не будут просмотрены все страницы. Если вы не хотите загружать все результаты поиска, освободите занятые ресурсы с помощью запроса [Освободить ресурсы просмотра прокрутки](https://yandex.ru/support/tracker/ru/api-ref/issues/search-release.md).

Ответ содержит заголовки:

- **Link**

    Ссылка для перехода на следующую страницу результатов поиска. Ссылку можно использовать только для перехода к следующей и к первой страницам.

- **X-Scroll-Id**

    Идентификатор страницы.

- **X-Scroll-Token**

    Токен, удостоверяющий принадлежность запроса текущему пользователю.

- **X-Total-Count**

    Общее число записей в ответе.

### Пример {#scroll-example}

Рассмотрим получение результатов поиска с использованием прокрутки на примере: найти все задачи, которые назначены на сотрудника.

Условия запроса:
- Используется HTTP-метод `POST`.
- Ключ очереди — «TREK».
- Исполнитель задачи — <логин_пользователя>.
- Результаты поиска должны быть отсортированы.

Последовательность выполнения серии запросов:

1. Создайте первый запрос серии с параметрами:
    - `scrollType=sorted`
    - `perScroll=100`
    - `scrollTTLMillis=10000`

    Пример:
    ```json translate=no
    POST /v3/issues/_search?scrollType=sorted&perScroll=100&scrollTTLMillis=10000
    Host: api.tracker.yandex.net
    Authorization: OAuth <OAuth-токен>
    X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

    {
      "filter": {
        "queue": "TREK",
        "assignee": "username"
      }
    }
    ```

    Ответ на запрос будет содержать список задач и заголовки:
    - `Link` — ссылки на первую и следующую страницы результатов:

       ```
       Link: <api.tracker.yandex.net/v3/issues/_search?expand=&embed=&fields=&staleOk=false&scrollType=sorted&scrollTTLMillis=10000&perScroll=2000>; rel="first"
       Link: <api.tracker.yandex.net/v3/issues/_search?expand=&embed=&fields=&staleOk=false&scrollTTLMillis=10000&scrollId=6554d4cbbda0de18********&scrollToken=dummy-token-you-dont-have-to-specify-it>; rel="next"
       ```

       Используйте ссылку из заголовка с параметром `rel="next"` для получения следующей страницы результатов.

    - `X-Total-Count` — общее количество задач в выдаче.

    Если запрошенная страница не последняя в списке результатов поиска, также возвращаются заголовки:
    - `X-Scroll-Id`. Значение используется в параметре `scrollId` для получения следующей страницы результатов.
    - `X-Scroll-Token`. Значение не используется в текущей версии API v3.

1. Создайте второй запрос серии с параметрами `scrollId` и `scrollToken`, полученными на предыдущем шаге.

    Пример:
    ```json translate=no
    POST /v3/issues/_search?scrollId=cXVlcnlU<...>&scrollTTLMillis=10000
    Host: api.tracker.yandex.net
    Authorization: OAuth <OAuth-токен>
    X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>

    {
      "filter": {
        "queue": "TREK",
        "assignee": "username"
      }
    }
    ```

    На запрос будет получен ответ со следующей страницей списка задач и очередными значениями `X-Scroll-Id` и `X-Scroll-Token`, если страница не окажется последней.

1. Продолжайте отправлять запросы на получение следующей страницы результатов до тех пор, пока не получите все задачи из выдачи.

[*filter]: Фильтр — это инструмент для поиска задач по условиям. Например, можно найти задачи в нужной очереди, где вы автор или исполнитель.
{% included (../_includes/answer-issue.md) %}
```json translate=no
[
    {
    "self": "https://api.tracker.yandex.net/v3/issues/TREK-9844",
    "id": "593cd211ef7e8a33********",
    "key": "TREK-9844",
    "version": 7,
    "lastCommentUpdatedAt": "2017-07-18T13:33:44.291+0000",
    "summary": "subtask",
    "parent": {
        "self": "https://api.tracker.yandex.net/v3/issues/JUNE-2",
        "id": "593cd0acef7e8a33********",
        "key": "JUNE-2",
        "display": "Task"
        },
    "aliases": [
            "JUNE-3"
        ],

    "updatedBy": {
        "self": "https://api.tracker.yandex.net/v3/users/11********",
        "id": "11********",
        "display": "Имя Фамилия",
        "cloudUid": "ajeppa7dgp53********",
        "passportUid": 11********
        },
    "description": "<#<html><head></head><body><div>test</div><div> </div><div> </div> </body></html>#>",
    "sprint": [
        {
            "self": "https://api.tracker.yandex.net/v3/sprints/53**",
            "id": "53**",
            "display": "Sprint 1"
        }
    ],
    "type": {
        "self": "https://api.tracker.yandex.net/v3/issuetypes/2",
        "id": "2",
        "key": "task",
        "display": "Задача"
        },
    "priority": {
        "self": "https://api.tracker.yandex.net/v3/priorities/2",
        "id": "2",
        "key": "normal",
        "display": "Средний"
        },

    "createdAt": "2017-06-11T05:16:01.339+0000",
    "followers": [
        {
        "self": "https://api.tracker.yandex.net/v3/users/11********",
        "id": "11********",
        "display": "Имя Фамилия",
        "cloudUid": "ajeppa7dgp53********",
        "passportUid": 11********
        }
        ],
    "createdBy": {
        "self": "https://api.tracker.yandex.net/v3/users/11********",
        "id": "11********",
        "display": "Имя Фамилия",
        "cloudUid": "ajeppa7dgp53********",
        "passportUid": 11********
        },
    "votes": 0,
    "assignee": {
        "self": "https://api.tracker.yandex.net/v3/users/11********",
        "id": "11********",
        "display": "Имя Фамилия",
        "cloudUid": "ajeppa7dgp53********",
        "passportUid": 11********
        },
    "project": {
        "primary": {
            "self": "https://api.tracker.yandex.net/v3/projects/1",
            "id": "1",
            "display": "New project"
        },
        "secondary": []
    },
    "queue": {
        "self": "https://api.tracker.yandex.net/v3/queues/TREK",
        "id": "111",
        "key": "TREK",
        "display": "My queue"
        },
    "updatedAt": "2017-07-18T13:33:44.291+0000",
    "status": {
        "self": "https://api.tracker.yandex.net/v3/statuses/1",
        "id": "1",
        "key": "open",
        "display": "Открыт"
        },
    "previousStatus": {
        "self": "https://api.tracker.yandex.net/v3/statuses/2",
        "id": "2",
        "key": "resolved",
        "display": "Решен"
        },
    "favorite": false
    },
    {...}
]
```

{% cut "Параметры ответа" %}

   <!-- source: ru/api-ref/_includes/issue-response-fields-note.md -->
   {% note info "" %}

   В таблице перечислены основные поля ответа. Полный список полей и их описание см. на странице [Параметры ответа](https://yandex.ru/support/tracker/ru/api-ref/issues/response-fields.md).

   Также в ответе могут содержаться глобальные пользовательские поля и локальные поля очередей.

   {% endnote %}
   <!-- endsource: ru/api-ref/_includes/issue-response-fields-note.md -->

   Параметр | Описание | Тип данных
   ----- | ----- | -----
   self | Адрес ресурса API, который содержит информацию о задаче | Строка
   id | Идентификатор задачи | Строка
   key | Ключ задачи | Строка
   version | Версия задачи. Каждое изменение параметров задачи увеличивает номер версии. <br>Редактирование задачи будет заблокировано, если версия достигнет предельного значения: для роботов `10100`, для пользователей `11100` | Число
   lastCommentUpdatedAt | Дата и время последнего добавленного комментария | Строка
   summary | Название задачи | Строка
   [parent](#parent) | Объект с информацией о родительской задаче | Объект
   aliases | Массив с информацией об альтернативных ключах задачи | Массив строк
   [updatedBy](#updated-by) | Объект с информацией о последнем сотруднике, изменявшим задачу | Объект
   description | Описание задачи | Строка
   [sprint](#sprint) | Массив объектов с информацией о спринте | Массив объектов
   [type](#type) | Объект с информацией о типе задачи | Объект
   [priority](#priority) | Объект с информацией о приоритете | Объект
   createdAt | Дата и время создания задачи | Строка
   [followers](#followers) | Массив объектов с информацией о наблюдателях задачи | Массив объектов
   [createdBy](#created-by) | Объект с информацией о создателе задачи | Объект
   votes | Количество голосов за задачу | Число
   [assignee](#assignee) | Объект с информацией об исполнителе задачи | Объект
   [project](#project) | Объект с информацией о проектах задачи | Объект
   [queue](#queue) | Объект с информацией об очереди задачи | Объект
   updatedAt | Дата и время последнего обновления задачи | Строка
   [status](#status) | Объект с информацией о статусе задачи | Объект
   [previousStatus](#previous-status) | Объект с информацией о предыдущем статусе задачи | Объект
   favorite | Признак избранной задачи:<ul><li>`true` — пользователь добавил задачу в избранное;</li><li>`false` — задача не добавлена в избранное</li></ul> | Логический
   tags | Теги задачи | Массив строк

   **Поля объекта** `parent`{#parent}

   <!-- source: ru/api-ref/_includes/issue.md -->
   Параметр | Описание | Тип данных
   ----- | ----- | -----
   self | Адрес ресурса API, который содержит информацию о задаче. | Строка
   id | Идентификатор задачи. | Строка
   key | Ключ задачи. | Строка
   display | Отображаемое название задачи. | Строка
   <!-- endsource: ru/api-ref/_includes/issue.md -->

   **Поля объекта** `updatedBy` {#updated-by}

   <!-- source: ru/api-ref/_includes/user.md -->
   Параметр | Описание | Тип данных
   ----- | ----- | -----
   self | Адрес ресурса API, который содержит информацию о пользователе. | Строка
   id | Идентификатор пользователя. | Строка
   display | Отображаемое имя пользователя. | Строка
   passportUid | Уникальный идентификатор аккаунта пользователя в организации Яндекс 360 для бизнеса и Яндекс ID. | Число
   cloudUid | Уникальный идентификатор пользователя в Yandex Identity Hub. | Строка
   <!-- endsource: ru/api-ref/_includes/user.md -->

   <!-- source: ru/api-ref/_includes/sprint.md -->
   **Поля объектов массива** `sprint` {#sprint}

   Параметр | Описание | Тип данных
   ----- | ----- | -----
   self | Адрес ресурса API, который содержит информацию о спринте. | Строка
   id | Идентификатор спринта. | Строка
   display | Отображаемое название спринта. | Строка
   <!-- endsource: ru/api-ref/_includes/sprint.md -->

   <!-- source: ru/api-ref/_includes/type.md -->
   **Поля объекта** `type` {#type}

   Параметр | Описание | Тип данных
   ----- | ----- | -----
   self | Адрес ресурса API, который содержит информацию о типе задаче. | Строка
   id | Идентификатор типа задачи. | Строка
   key | Ключ типа задачи. | Строка
   display | Отображаемое название типа задачи. | Строка
   <!-- endsource: ru/api-ref/_includes/type.md -->

   <!-- source: ru/api-ref/_includes/priority.md -->
   **Поля объекта** `priority` {#priority}

   Параметр | Описание | Тип данных
   ----- | ----- | -----
   self | Адрес ресурса API, который содержит информацию о приоритете. | Строка
   id | Идентификатор приоритета. | Строка
   key | Ключ приоритета. | Строка
   display | Отображаемое название приоритета. | Строка
   <!-- endsource: ru/api-ref/_includes/priority.md -->

   **Поля объектов массива** `followers` {#followers}

   <!-- source: ru/api-ref/_includes/user.md -->
   Параметр | Описание | Тип данных
   ----- | ----- | -----
   self | Адрес ресурса API, который содержит информацию о пользователе. | Строка
   id | Идентификатор пользователя. | Строка
   display | Отображаемое имя пользователя. | Строка
   passportUid | Уникальный идентификатор аккаунта пользователя в организации Яндекс 360 для бизнеса и Яндекс ID. | Число
   cloudUid | Уникальный идентификатор пользователя в Yandex Identity Hub. | Строка
   <!-- endsource: ru/api-ref/_includes/user.md -->

   **Поля объекта** `createdBy` {#created-by}

   <!-- source: ru/api-ref/_includes/user.md -->
   Параметр | Описание | Тип данных
   ----- | ----- | -----
   self | Адрес ресурса API, который содержит информацию о пользователе. | Строка
   id | Идентификатор пользователя. | Строка
   display | Отображаемое имя пользователя. | Строка
   passportUid | Уникальный идентификатор аккаунта пользователя в организации Яндекс 360 для бизнеса и Яндекс ID. | Число
   cloudUid | Уникальный идентификатор пользователя в Yandex Identity Hub. | Строка
   <!-- endsource: ru/api-ref/_includes/user.md -->

   **Поля объекта** `assignee` {#assignee}

   <!-- source: ru/api-ref/_includes/user.md -->
   Параметр | Описание | Тип данных
   ----- | ----- | -----
   self | Адрес ресурса API, который содержит информацию о пользователе. | Строка
   id | Идентификатор пользователя. | Строка
   display | Отображаемое имя пользователя. | Строка
   passportUid | Уникальный идентификатор аккаунта пользователя в организации Яндекс 360 для бизнеса и Яндекс ID. | Число
   cloudUid | Уникальный идентификатор пользователя в Yandex Identity Hub. | Строка
   <!-- endsource: ru/api-ref/_includes/user.md -->

   **Поля объекта** `project` {#project}

   <!-- source: ru/api-ref/_includes/project.md -->
   Параметр | Описание | Тип данных
   -------- | -------- | ----------
   [primary](#project-id) | Основной проект задачи | Объект
   [secondary](#project-id) | Список дополнительных проектов задачи | Массив объектов

   {% note info "" %}

   Если в адресе запроса указана версия API `v2`, объект `project` содержит информацию только об основном проекте.

   {% endnote %}
   <!-- endsource: ru/api-ref/_includes/project.md -->

   **Поля объекта, содержащего данные проекта** {#project-id}

   Параметры `primary` и `secondary` содержат объекты со следующими полями:

   <!-- source: ru/api-ref/_includes/project.md -->
   Параметр | Описание | Тип данных
   ----- | ----- | -----
   self | Адрес ресурса API, который содержит информацию о проекте. | Строка
   id | Идентификатор проекта. | Строка
   display | Отображаемое название проекта. | Строка
   <!-- endsource: ru/api-ref/_includes/project.md -->


   **Поля объекта** `queue` {#queue}

   <!-- source: ru/api-ref/_includes/queue.md -->
   Параметр | Описание | Тип данных
   ----- | ----- | -----
   self | Адрес ресурса API, который содержит информацию об очереди. | Строка
   id | Идентификатор очереди. | Строка
   key | Ключ очереди. | Строка
   display | Отображаемое название очереди. | Строка
   <!-- endsource: ru/api-ref/_includes/queue.md -->

   **Поля объекта** `status` {#status}

   <!-- source: ru/api-ref/_includes/status.md -->
   Параметр | Описание | Тип данных
   ----- | ----- | -----
   self | Адрес ресурса API, который содержит информацию о статусе. | Строка
   id | Идентификатор статуса. | Строка
   key | Ключ статуса. | Строка
   display | Отображаемое название статуса. | Строка
   <!-- endsource: ru/api-ref/_includes/status.md -->

   **Поля объекта** `previousStatus` {#previous-status}

   <!-- source: ru/api-ref/_includes/status.md -->
   Параметр | Описание | Тип данных
   ----- | ----- | -----
   self | Адрес ресурса API, который содержит информацию о статусе. | Строка
   id | Идентификатор статуса. | Строка
   key | Ключ статуса. | Строка
   display | Отображаемое название статуса. | Строка
   <!-- endsource: ru/api-ref/_includes/status.md -->

{% endcut %}

{% endincluded %}
{% included (../_includes/answer-issue.md:issue-response-fields-note.md) %}
{% note info "" %}

В таблице перечислены основные поля ответа. Полный список полей и их описание см. на странице [Параметры ответа](https://yandex.ru/support/tracker/ru/api-ref/issues/response-fields.md).

Также в ответе могут содержаться глобальные пользовательские поля и локальные поля очередей.

{% endnote %}

{% endincluded %}
{% included (../_includes/answer-issue.md:issue.md) %}
Параметр | Описание | Тип данных
----- | ----- | -----
self | Адрес ресурса API, который содержит информацию о задаче. | Строка
id | Идентификатор задачи. | Строка
key | Ключ задачи. | Строка
display | Отображаемое название задачи. | Строка
{% endincluded %}
{% included (../_includes/answer-issue.md:user.md) %}
Параметр | Описание | Тип данных
----- | ----- | -----
self | Адрес ресурса API, который содержит информацию о пользователе. | Строка
id | Идентификатор пользователя. | Строка
display | Отображаемое имя пользователя. | Строка
passportUid | Уникальный идентификатор аккаунта пользователя в организации Яндекс 360 для бизнеса и Яндекс ID. | Число
cloudUid | Уникальный идентификатор пользователя в Yandex Identity Hub. | Строка

{% endincluded %}
{% included (../_includes/answer-issue.md:sprint.md) %}
**Поля объектов массива** `sprint` {#sprint}

Параметр | Описание | Тип данных
----- | ----- | -----
self | Адрес ресурса API, который содержит информацию о спринте. | Строка
id | Идентификатор спринта. | Строка
display | Отображаемое название спринта. | Строка
{% endincluded %}
{% included (../_includes/answer-issue.md:type.md) %}
**Поля объекта** `type` {#type}

Параметр | Описание | Тип данных
----- | ----- | -----
self | Адрес ресурса API, который содержит информацию о типе задаче. | Строка
id | Идентификатор типа задачи. | Строка
key | Ключ типа задачи. | Строка
display | Отображаемое название типа задачи. | Строка
{% endincluded %}
{% included (../_includes/answer-issue.md:priority.md) %}
**Поля объекта** `priority` {#priority}

Параметр | Описание | Тип данных
----- | ----- | -----
self | Адрес ресурса API, который содержит информацию о приоритете. | Строка
id | Идентификатор приоритета. | Строка
key | Ключ приоритета. | Строка
display | Отображаемое название приоритета. | Строка
{% endincluded %}
{% included (../_includes/answer-issue.md:project.md) %}
# Project Request {#request}

Параметр | Описание | Тип данных
-------- | -------- | ----------
primary | Идентификатор основного проекта задачи (поле проекта `shortId`) | Число
secondary | Идентификаторы дополнительных проектов задачи (поле проекта `shortId`) | Массив чисел

{% note info "" %}

Если в адресе запроса указана версия API `v2`, параметр `project` может содержать только идентификатор основного проекта.

Например: `"project": 1234`

{% endnote %}

# Project Response {#response}

Параметр | Описание | Тип данных
-------- | -------- | ----------
[primary](#project-id) | Основной проект задачи | Объект
[secondary](#project-id) | Список дополнительных проектов задачи | Массив объектов

{% note info "" %}

Если в адресе запроса указана версия API `v2`, объект `project` содержит информацию только об основном проекте.

{% endnote %}

# Project ID {#project-id}

Параметр | Описание | Тип данных
----- | ----- | -----
self | Адрес ресурса API, который содержит информацию о проекте. | Строка
id | Идентификатор проекта. | Строка
display | Отображаемое название проекта. | Строка


{% endincluded %}
{% included (../_includes/answer-issue.md:queue.md) %}
Параметр | Описание | Тип данных
----- | ----- | -----
self | Адрес ресурса API, который содержит информацию об очереди. | Строка
id | Идентификатор очереди. | Строка
key | Ключ очереди. | Строка
display | Отображаемое название очереди. | Строка
{% endincluded %}
{% included (../_includes/answer-issue.md:status.md) %}
Параметр | Описание | Тип данных
----- | ----- | -----
self | Адрес ресурса API, который содержит информацию о статусе. | Строка
id | Идентификатор статуса. | Строка
key | Ключ статуса. | Строка
display | Отображаемое название статуса. | Строка
{% endincluded %}