# Pagination

Pagination helps manage large datasets by dividing results into pages. Use the `page` query parameter to control the
size of each page and specify which page to retrieve.

If pagination is not applied, some endpoints may return all records in a single response.

Important

- Pagination applies to any endpoint that returns a resource collection as primary data, regardless of the request type.
- Page size is **50** by default, unless it is overridden at a particular endpoint.
- The maximum page size is **100**, unless it is overridden at a particular endpoint.
- If `page[number]` is not specified, page **1** is returned by default.
- Some endpoints may disable pagination and return all records in a single response.

---



## Define page size

Use the `page[size]` parameter to set the maximum number of items returned per page.

In this example, the cities collection returns up to 10 records per page.
If `page[size]` is not specified, page size is **50** by default, unless it is overridden at a particular endpoint.

[[DIDWW-API-EXAMPLE-START]]

http

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

curl

```
curl -i -X GET 'https://api.didww.com/v3/cities?page%5Bsize%5D=10' -H "Accept: application/vnd.api+json" -H "Api-Key: YOUR_API_KEY"
```

[[DIDWW-API-EXAMPLE-END]]

---

## Retrieve a specific page

Use the `page[number]` parameter to request a specific page of results.

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 in the data.

[[DIDWW-API-EXAMPLE-START]]

http

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

curl

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

[[DIDWW-API-EXAMPLE-END]]

---

## Pagination links

Paginated responses include navigation links in the top-level `links` object:

- `first` - the first page of data
- `last` - the last page of data
- `prev` - the previous page of data
- `next` - the next page of data

These links help you navigate through paginated results without manually calculating page numbers.

Follow the `next` link returned by the server while another page is available.
Preserve your filters and requested includes when paging through a collection.
Check the endpoint's [OpenAPI Reference](../2026-04-16/api-reference.html) for
pagination support and endpoint-specific page-size limits. The Countries collection,
for example, does not use pagination.

On this page