Developer Portal for YouTrack and Hub
 

Pagination

Last modified: 7 November 2024

This page describes pagination options in the YouTrack REST API.

All resources that return collections of entities limit the number of returned entities by default. If you do not explicitly specify the number of entities to return with the $top query parameter, the server returns a part of the collection.

For most resources, the server returns a maximum of 42 elements by default. To get the entire collection, you need to use pagination.

There are two pagination options that the YouTrack REST API utilizes:

  • The vast majority of resources use pagination with $top and $skip query parameters. To learn more about these parameters, see General Pagination.

  • Resources that work with issue-related activities use cursors for pagination. To learn more about cursors, see Pagination for Activities.