Pagination¶

To paginate the primary data, supply pagination links in the top-level links object.

The following keys used for pagination links:

first: the first page of data

last: the last page of data

prev: the previous page of data

next: the next page of data

The page query parameter is reserved for pagination, for example query parameters such as page[number] and page[size].

The page[size] defines the maximum number of individual entries (such as cities, countries or DIDs) that are returned in the data.

http

GET /cities?page%5Bsize%5D=10 HTTP/1.1
Host: api.didww.com
Accept: application/vnd.api+json

curl

curl -i 'https://api.didww.com/cities?page%5Bsize%5D=10' -H 'Accept: application/vnd.api+json'

The page[number] relates to the page[size] parameter and defines the page number of the returned data.

For example, if the page[size] is set to 10 and the page[number] is set to 3, entry numbers 21 to 30 will be returned to the data.

Maximum page size is 100 by default, unless it is overridden at a particular endpoint.

If the page[number] is not defined, page number 1 is returned.

Page number is 50 by default, unless it is overridden at a particular endpoint.

Keep in mind that pagination is disabled for certain destinations - in such cases, a request without filters will return all records.

http

GET /v3/cities?page%5Bnumber%5D=3&page%5Bsize%5D=10 HTTP/1.1
Host: api.didww.com
Accept: application/vnd.api+json

curl

curl -i 'https://api.didww.com/v3/cities?page%5Bnumber%5D=3&page%5Bsize%5D=10' -H 'Accept: application/vnd.api+json'

Note

This section applies to any endpoint that responds with a resource collection as primary data, regardless of the request type.