Pagination
API requests that return collections of records are always paginated.
The default page size of 20 records can be adjusted by setting the ?per_page=
parameter.
The maximum number of records per page is 100.
Use the Link Header to browse through the pages of the result.
$ curl https://api.r-service.tech/v1/requests?per_page=25&search_after=eyJvZmZzZXQiOjUsImN1cnNvciI
Pagination information will be returned in the response header.
X-Pagination-Per-Page: 25
X-Pagination-Current-Page: 3
X-Pagination-Total-Pages: 10
X-Pagination-Total-Entries: 243
Link Header
Use the the Link header to browse through the pages of the result:
Link: <https://api.r-service.tech/v1/requests?per_page=25>; rel="first",
<https://api.r-service.tech/v1/requests?per_page=25&search_before=IicvNnc1NmIsUjOiQXZzZmZvJye>; rel="prev",
<https://api.r-service.tech/v1/requests?per_page=25&search_after=eyJvZmZzZXQiOjUsImN1cnNvciIx>; rel="next"
The possible rel
values are:
- first
- Shows the URL of the first page of results. This value is present in the Link header of all pages, except the first.
- prev
- Shows the URL of the immediate previous page of results. This value is present in the Link header of all pages, except the first.
- next
- Shows the URL of the immediate next page of results. This value is present in the Link header of all pages, except the last.
Throttling
In some cases, most notably the Audit Entries and Notes APIs, the maximum number of records that can be retrieved as a single collection of pages is limited to 100.000 records. When more than 100.000 records are found by an API request, the following is included in the HTTP Response Header:
X-Pagination-Throttled: true