> For the complete documentation index, see [llms.txt](https://developer.dashdoc.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.dashdoc.com/docs/get-started/core-api-concepts/pagination.md).

# Pagination

{% hint style="info" %}
Most collection endpoints in the Dashdoc API are **paginated**. By default, results are returned in pages of **20 or 100 items**, depending on the endpoint.
{% endhint %}

### Requesting Pages

To navigate through paginated data, use the `page` query parameter:

```url
GET /api/v4/transports/?page=2
```

If the `page` parameter is not specified, the API will return the **first page** (`?page=1` by default).

{% hint style="danger" %}
If your integration processes large datasets, make sure to iterate over pages using the `next` URL until it returns `null`.
{% endhint %}

***

### Response Format

Paginated responses follow a consistent schema:

{% hint style="warning" %}
The maximum number of items per page varies depending on the endpoint (usually 20 or 100).
{% endhint %}

{% code lineNumbers="true" %}

```json
{
  "count": 100,
  "next": "https://api.dashdoc.com/api/v4/transports/?page=3",
  "previous": "https://api.dashdoc.com/api/v4/transports/?page=1",
  "results": [
    ...
  ]
}
```

{% endcode %}

**Fields**

* **`count`**:\
  Total number of items matching your request, across all pages.
* **`next`**:\
  URL to retrieve the next page of results (or `null` if you are on the last page).
* **`previous`**:\
  URL to retrieve the previous page of results (or `null` if you are on the first page).
* **`results`**:\
  The list of objects contained in the current page.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.dashdoc.com/docs/get-started/core-api-concepts/pagination.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.