---
metadata:
  - name: generator
    content: Diplodoc Platform v5.47.3
alternate:
  - https://yandex.com.tr/support/tracker/en/api-ref/queues/get-queues.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/support/tracker/en/llms.txt

# Getting a list of queues

Use this request to get a list of available queues. If there are more than 50 queues in the response, use [pagination](https://yandex.com.tr/support/tracker/en/api-ref/common-format.md#displaying-results).

<div class="request_example method_get yfm-clipboard">
    <p>GET</p>
    <pre><code>https://api.tracker.yandex.net/v3/queues/</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: en/_assets/style/methods.md -->

<!-- endsource: en/_assets/style/methods.md -->

## Query format {#query}

Before making a request, [get permission to access the API](https://yandex.com.tr/support/tracker/en/api-ref/access.md).

To search for issues, use an HTTP `GET` request.

```
GET /v3/queues/
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth_token>
X-Org-ID or X-Cloud-Org-ID: <organization_ID>
```

<!-- source: en/_includes/api/headings.md -->
{% cut "Headers" %}

* `Host`: address of the node that provides the API.

* <!-- source: en/_includes/api/authorization.md -->
  `Authorization`: Authorization token about these formats:

    - `OAuth <OAuth_token>`: For authorization using the OAuth 2.0 protocol. [Learn more](https://yandex.com.tr/support/tracker/en/api-ref/access.md#about_OAuth)

    - `Bearer <IAM_token>`: For authorization using an IAM token, if a Yandex Cloud Organization organization is linked to Tracker. [Learn more](https://yandex.com.tr/support/tracker/en/api-ref/access.md#iam-token)
  <!-- endsource: en/_includes/api/authorization.md -->


* <!-- source: en/_includes/api/org-id.md -->
  `X-Org-ID` or `X-Cloud-Org-ID`: Organization ID.

  - Use the `X-Org-ID` header if a Tracker organization is linked to Yandex 360 for Business.

  - Use the `X-Cloud-Org-ID` header if a Tracker organization is linked to Yandex Cloud Organization.

  To get the organization ID, go to **Administration** → [**Organizations**](https://tracker.yandex.com/admin/orgs) and copy the value from the **ID** field. {#find-id}
  <!-- endsource: en/_includes/api/org-id.md -->


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

{% cut "Request parameters" %}

**Additional parameters**

| Parameter | Description | Data type |
----- | ----- | -----
| expand | Additional fields to include in the response The possible values include:<ul><li>`projects`: Queue projects.</li><li>`components`: Components.</li><li>`versions`: Versions.</li><li>`types`: Issue types.</li><li>`team`: List of team members.</li><li>`workflows`: Workflows.</li></ul> | String |
| perPage | Number of queues per response page. The default value is 50. To set up additional response output parameters, use [pagination](#view-pages). | Integer |

{% endcut %}

> Example: Get a list of issues with additional filtering options.
>
> - HTTP `GET` method is used.
>
> ```
> GET https://api.tracker.yandex.net/v3/queues
> ```

## Response format {#answer}

<!-- source: en/_includes/api/answer-200.md -->
If the request is successful, the API returns a response with code `200 OK`.
<!-- endsource: en/_includes/api/answer-200.md -->

```json
[
  {
    "self": "https://api.tracker.yandex.net/v3/queues/TEST",
    "id": "3",
    "key": "TEST",
    "version": 5,
    "name": "Test",
    "description": "Queue created for testing purposes",
    "lead": {
           "self": "https://api.tracker.yandex.net/v3/users/11********",
           "id": "11********",
           "display": "Ivan Ivanov"
    },
    "assignAuto": false,
    "defaultType": {
           "self": "https://api.tracker.yandex.net/v3/issuetypes/1",
           "id": "1",
           "key": "bug",
           "display": "Error"
    },
    "defaultPriority": {
           "self": "https://api.tracker.yandex.net/v3/priorities/3",
           "id": "3",
           "key": "normal",
           "display": "Normal"
    },
    "teamUsers": [
           {
               "self": "https://api.tracker.yandex.net/v3/users/11********",
               "id": "11********",
               "display": "Ivan Ivanov"
           },
           ...
    ],
    "issueTypes": [
           {
               "self": "https://api.tracker.yandex.net/v3/issuetypes/1",
               "id": "1",
               "key": "bug",
               "display": "Error"
           },
           ...
    ],
    "versions": [
           {
               "self": "https://api.tracker.yandex.net/v3/versions/4",
               "id": "4",
               "display": "Peek-a-boo"
        }
    ],
    "workflows": {
           "dev": [
               {
                    "self": "https://api.tracker.yandex.net/v3/issuetypes/1",
                    "id": "1",
                    "key": "bug",
                    "display": "Errror"
                },
                ...
           ]
    },
    "denyVoting": false,
    "issueTypesConfig": [
           {
               "issueType": {
                      "self": "https://api.tracker.yandex.net/v3/issuetypes/1",
                      "id": "1",
                      "key": "bug",
                      "display": "Error"
            },
            "workflow": {
                      "self": "https://api.tracker.yandex.net/v3/workflows/dev",
                      "id": "dev",
                      "display": "dev"
            },
            "resolutions": [
                   {
                      "self": "https://api.tracker.yandex.net/v3/resolutions/2",
                      "id": "2",
                      "key": "wontFix",
                      "display": "Won't fix"
                   },
                ...
            ]
        },
        ...
    ]
  },
  ...
]
```

{% cut "Response parameters" %}

| Parameter | Description | Data type |
----- | ----- | -----
| self | Queue link. | String |
| id | Queue ID. | Number in string format |
| key | Queue key. | String |
| version | Queue version. Each change to the queue increases its version number. | Number |
| name | Queue name | String |
| description | Text description of the queue | String |
| [lead](#lead) | Block with information about the queue owner | Map item |
| assignAuto | Automatically assign new issues in the queue:<ul><li>`true`: Assign</li><li>`false`: Do not assign</li></ul> | Boolean |
| [defaultType](#default-type) | Block with information about the default issue type | Map item |
| [defaultPriority](#default-priority) | Block with information about the default issue priority | Map item |
| [teamUsers](#team-users) | Array with information about queue team members | Array of objects |
| [issueTypes](#issue-types) | Array with information about queue issue types | Array of objects |
| [versions](#versions) | Array with information about queue versions | Array of objects |
| [workflows](#workflows) | List of queue workflows and their issue types | Array |
| denyVoting | Flag that shows whether voting for issues is enabled | Boolean |
| [issueTypesConfig](#issue-types-config) | Array with queue issue settings | Array of objects |

<!-- source: en/_includes/api/user.md -->
| Parameter | Description | Data type |
----- | ----- | -----
| self | Address of the API resource with information about the user | String |
| id | User ID. | String |
| display | Displayed user name | String |
| passportUid | Unique ID of the user account in the Yandex 360 for Business organization and Yandex ID. | Number |
| cloudUid | Unique user ID in Yandex Cloud Organization | String |
<!-- endsource: en/_includes/api/user.md -->

`defaultType` **object fields** {#default-type}

| Parameter | Description | Data type |
----- | ----- | -----
| self | Link to the issue type | String |
| id | ID of the issue type | String |
| key | Key of the issue type | String |
| display | Issue type name displayed | String |

`defaultPriority` **object fields** {#default-priority}

| Parameter | Description | Data type |
----- | ----- | -----
| self | Link to the priority type | String |
| id | Priority ID | String |
| key | Priority key | String |
| display | Priority name displayed | String |

`teamUsers` **array object fields** {#team-users}

| Parameter | Description | Data type |
----- | ----- | -----
| self | Link to the user | String |
| id | User ID | String |
| display | User name displayed | String |

`issueTypes` **array object fields** {#issue-types}

| Parameter | Description | Data type |
----- | ----- | -----
| self | Link to the issue type | String |
| id | ID of the issue type | String |
| key | Key of the issue type | String |
| display | Issue type name displayed | String |

`versions` **array object fields** {#versions}

| Parameter | Description | Data type |
----- | ----- | -----
| self | Link to the queue version | String |
| id | Version ID | String |
| display | Version name displayed | String |

`workflows` **array object fields** {#workflows}

| Parameter | Description | Data type |
----- | ----- | -----
| self | Link to the issue type | String |
| id | ID of the issue type | String |
| key | Key of the issue type | String |
| display | Issue type name displayed | String |

`issueTypesConfig` **array object fields** {#issue-types-config}

| Parameter | Description | Data type |
----- | ----- | -----
| [issueType](#issue-type) | Block with information about the issue type | Map item |
| [workflow](#workflow) | Block with information about the issue type workflow | Map item |
| [resolutions](#resolutions) | Array with possible issue type resolutions | Array of objects |

`issueType` **object fields** {#issue-type}

| Parameter | Description | Data type |
----- | ----- | -----
| self | Link to the issue type | String |
| id | ID of the issue type | String |
| key | Key of the issue type | String |
| display | Issue type name displayed | String |

`workflow` **object fields** {#workflow}

| Parameter | Description | Data type |
----- | ----- | -----
| self | Link to the workflow object | String |
| id | Workflow ID | String |
| display | Workflow name displayed | String |

`resolutions` **array object fields** {#resolutions}

| Parameter | Description | Data type |
----- | ----- | -----
| self | Link to the resolution object | String |
| id | Resolution ID | String |
| key | Resolution ID | String |
| display | Resolution name displayed | String |

{% endcut %}