---
metadata:
  - name: generator
    content: Diplodoc Platform v5.57.3
  - property: og:type
    content: article
  - property: article:section
    content: Справочник API
  - property: og:title
    content: Получить параметры всех досок с поддержкой пагинации
  - property: article:tag
    content: Техническая инструкция
alternate:
  - https://yandex.com.tr/support/tracker/en/api/boards/get-boards-paginate.md
  - href: https://yandex.com.tr/support/tracker/en/api/boards/get-boards-paginate.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.com.tr/support/tracker/en/llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/support/tracker/en/llms.txt


# Get all board parameters with pagination

This request returns parameters of all [issue boards](*board) created in your organization with relative pagination support. This request returns no more than 500 records.

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

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

## Request format {#query}

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

To get parameters of all issue boards, send an HTTP `GET` request.

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

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

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

* <!-- source: en/api/_includes/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/access.md#about_OAuth)

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


* <!-- source: en/api/_includes/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 Identity Hub.

  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/api/_includes/org-id.md -->


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

{% cut "Request parameters" %}

**Additional parameters**

Parameter | Description | Data type
-------- | -------- | ----------
perPage | The number of items per page, no more than 500. | Number
id | The board ID to start the next page of results from. Used for pagination. | Number

{% endcut %}

## Pagination mechanism {#pagination}

The request uses relative pagination:

- Items are sorted in ascending order of board ID.
- To get the next page, use the ID of the last board from the previous page as the value of the `id` parameter.

### Example of sequential requests

1. First request:
   ```
   GET /v3/boards/_paginate?perPage=20
   ```

2. Next request:
   ```
   GET /v3/boards/_paginate?perPage=20&id=<last_board_id>
   ```

## Response format {#answer}

{% list tabs %}

- Request succeeded

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

    The response body contains a JSON array with parameters of all boards created by users in your organization.

    ```json
    [
      {
        "self": "https://api.tracker.yandex.net/v3/boards/1",
        "id": 1,
        "version": 1,
        "name": "My board",
        "createdAt": "2026-01-22T09:02:18.647+0000",
        "updatedAt": "2026-01-22T09:02:18.647+0000",
        "createdBy": {
            "self": "https://api.tracker.yandex.net/v3/users/112000***",
            "id": "username",
            "display": "User Name",
            "cloudUid": "ajevuhegoggfk*******",
            "passportUid": 112000***
        },
        "columns": [
        {
            "self": "https://api.tracker.yandex.net/v3/boards/1/columns/1",
            "id": "1",
            "display": "Open"
        },
        ...
        ],
        "useRanking": false,
        "estimateBy": {
            "self": "https://api.tracker.yandex.net/v3/fields/storyPoints",
            "id": "storyPoints",
            "display": "Story Points"
        },
        "country": {
            "self": "https://api.tracker.yandex.net/v3/countries/1",
            "id": "1",
            "display": "Россия"
        },
        "calendar": {
            "id": 6
        }
      },
      ...
    ]
    ```

    {% cut "Response parameters" %}

    #|
    || Parameter | Description | Data type ||
    || self | URL of the API resource containing board parameters | String ||
    || id | Board ID | Number ||
    || version | Board version. Each change to the board increments the version number | Number ||
    || name | Board name | String ||
    || createdAt | Board creation date in the `YYYY-MM-DDThh:mm:ss.sss±hhmm` format | String ||
    || updatedAt | Board last update date in the `YYYY-MM-DDThh:mm:ss.sss±hhmm` format | String ||
    || [createdBy](#createdby) | Information about the user who created the board | Object ||
    || [columns](#ans-columns) | Information about board columns | Array of objects ||
    || useRanking | *This parameter is obsolete and does not affect board operation.*

    Whether you can change the order of issues on the board:<ul><li>`true`: allowed;</li><li>`false`: not allowed.</li></ul> | Boolean ||
    || estimateBy | *This parameter is obsolete and does not affect board operation.*

    Information about the issue field used to estimate effort | Object ||
    || country | *This parameter is obsolete and does not affect board operation.*

    Country information | Object ||
    || calendar | An object that contains the calendar ID. Calendar data is used in the issue burn down chart. | Object ||
    || [autoFilterSettings](#autofilterset) | Information about filter settings that are used to automatically add issues to the board and remove issues from the board | Object ||
    |#

    **Fields of the `createdBy` object** {#createdby}

    <!-- source: en/api/_includes/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 Identity Hub | String |
    <!-- endsource: en/api/_includes/user.md -->

    **Fields of the `columns` object** {#ans-columns}

    <!-- source: en/api/_includes/board-fields.md -->
    Parameter | Description | Data type
    -------- | -------- | ----------
    self | Address of the API resource with information about the issue parameter | String
    id | Issue parameter ID | String
    display | Displayed parameter name | String
    <!-- endsource: en/api/_includes/board-fields.md -->

    **Fields of the `autoFilterSettings` object** {#autofilterset}

    <!-- source: en/api/_includes/board-fields.md -->
    Parameter | Description | Data type
    -------- | -------- | ----------
    addFilterSettings | Object with filter settings for automatically adding issues to the board | Object
    removeFilterSettings | Object with filter settings for automatically removing issues from the board | Object
    <!-- endsource: en/api/_includes/board-fields.md -->

    {% endcut %}

- Request failed

    If the request failed, the API returns a response with an error code:

    <!-- source: en/api/_includes/answer-error-400.md -->
    400
    :   One or more request parameters have an invalid value.
    <!-- endsource: en/api/_includes/answer-error-400.md -->

    <!-- source: en/api/_includes/answer-error-403.md -->
    403
    :   You are not authorized to perform this action. You can check what rights you have in the Tracker interface. The same rights are required to perform an action via the API and interface.
    <!-- endsource: en/api/_includes/answer-error-403.md -->

    <!-- source: en/api/_includes/answer-error-404.md -->
    404
    :   The requested object was not found. You may have specified an invalid object ID or key.
    <!-- endsource: en/api/_includes/answer-error-404.md -->

    <!-- source: en/api/_includes/answer-error-500.md -->
    500
    :   Internal service error. Try again later.
    <!-- endsource: en/api/_includes/answer-error-500.md -->

    <!-- source: en/api/_includes/answer-error-503.md -->
    503
    :   The API service is temporarily unavailable.
    <!-- endsource: en/api/_includes/answer-error-503.md -->

{% endlist %}

[*board]: An issue board is a visual representation of issues arranged in columns. Each column corresponds to a status, for example ![](../../_assets/svg/initial.svg), ![](../../_assets/svg/progress.svg), ![](../../_assets/svg/end.svg).