> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vantage.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Pagination

> Understand how to paginate through large sets of data.

When querying for lists of items, the responses will be paginated. The pagination will be represented in the `links` key of the response.

```json theme={null}
"links":{
  "self": "https://api.vantage.sh/v2/folders?page=2",
  "first": "https://api.vantage.sh/v2/folders?page=1",
  "next": "https://api.vantage.sh/v2/folders?page=3",
  "last": "https://api.vantage.sh/v2/folders?page=5",
  "prev": "https://api.vantage.sh/v2/folders?page=1"
}
```

| Field   | Description                            |
| ------- | -------------------------------------- |
| `self`  | The URL of the current page.           |
| `first` | The URL of the first page of items.    |
| `next`  | The URL of the next page of items.     |
| `last`  | The URL of the last page of items.     |
| `prev`  | The URL of the previous page of items. |

The array of items will be available as a key that matches the name of the route. For instance, folders will have a top-level `folders` key.

```json theme={null}
{
  "links": {},
  "folders":[]
}
```

You can specify the page you want to access and the number of items per page by using the `page` and `limit` query parameters.

```bash theme={null}
curl --request GET \
  --url https://api.vantage.sh/v2/folders?page=3&limit=10 \
  --header 'Accept: application/json'
```