---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.0
alternate:
  - https://yandex.com/dev/market/partner-api/doc/en/concepts/pagination.md
  - https://yandex.com/dev/market/partner-api/doc/ru/concepts/pagination.md
  - https://yandex.com/dev/market/partner-api/doc/zh/concepts/pagination.md
  - href: en/concepts/pagination.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.com/dev/market/partner-api/doc/en/llms.txt

# Pagination in requests to Yandex Market API for sellers

Some queries do not return the result in its entirety, but page by page. To get the full result, run several consecutive queries. — in each new request, pass a parameter with the next page of results.

{% note warning "Outdated type of pagination" %}

Some methods support pagination with the page number (parameter `page`). This type of pagination is outdated — don't use it. If both types of pagination are available in the method, use `pageToken`.

{% endnote %}

## How to get all the result pages {#page-token}

Examples of methods with pagination by `pageToken`:

* [POST v2/businesses/{businessId}/offer-cards](https://yandex.com/dev/market/partner-api/doc/en/reference/content/getOfferCardsContentStatus.md)
* [POST v2/campaigns/{campaignId}/offer-prices](https://yandex.com/dev/market/partner-api/doc/en/reference/prices/getPricesByOfferIds.md)
* [GET v2/campaigns/{campaignId}/returns](https://yandex.com/dev/market/partner-api/doc/en/reference/returns/getReturns.md)
* [POST v1/businesses/{businessId}/orders](https://yandex.com/dev/market/partner-api/doc/en/reference/orders/getBusinessOrders.md)

To get the full result:

1. Make a request where:

   * Don't pass it on `pageToken`.
   * If desired, send `limit`. In the specification of each method for the parameter `limit` the values are specified `minimum`, `maximum` and `default`. If you do not pass the parameter, the default value will be used.

   {% note warning "Automatic reduction `limit`" %}

   Some methods automatically reduce the passed value. `limit` before `maximum` if it exceeds the allowed maximum — this is indicated in the parameter description. `limit` such methods.

   Examples of methods:
      * [GET v2/campaigns/{campaignId}/returns](https://yandex.com/dev/market/partner-api/doc/en/reference/returns/getReturns.md)
      * [POST v1/businesses/{businessId}/orders](https://yandex.com/dev/market/partner-api/doc/en/reference/orders/getBusinessOrders.md)

   {% endnote %}

   The response will return the parameter `paging`.

2. If in `paging` the parameter returned `nextPageToken` so there is the next page of the result. Repeat the request, where pass the value `nextPageToken` in the parameter `pageToken`.

   {% note warning "Parameter value `nextPageToken`" %}

   This is not a page number, but a string that needs to be passed in the request.

   {% endnote %}

   If there is no parameter, then the last page is returned. Make more requests **no need**.

3. Keep executing requests until it returns `nextPageToken`.