---
title: Pagination
description: Efficiently retrieve data with Storyblok's pagination feature. Customize results with page and per_page parameters
url: https://storyblok.com/docs/api/management/getting-started/pagination
---

# Pagination

To efficiently handle large datasets, the Storyblok API supports pagination for all top-level resources, including `stories`, `assets`, and `datasources`.

The query accepts two parameters:

| Parameter | Description |
| --- | --- |
| `page` | Default: `1`. The page number to retrieve. Increase the value to receive the next page of entries. |
| `per_page` | Default: `25`. The number of entries per page. The maximum for stories is `100`, and for datasource entries is `1000`. |

The response headers of paginated API requests include two properties:

-   `total`: the total number of items available across all pages.
-   `per_page`: the number of items per page.

To calculate how many pages are available, use the `total` response header received after the first request: divide the `total` value by the `per_page` value. The result is the last available page number.

If the request specifies a page number greater than the result, the API response returns an empty array.

## Pagination

-   [Previous: Organization](/docs/api/management/getting-started/organization)
-   [Next: Rate Limit](/docs/api/management/getting-started/rate-limit)