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

# Pagination

> List endpoints use keyset pagination, with a limit per request and a cursor for the next page

List endpoints return one page of results at a time. You choose how many results a page holds with `limit`, and follow the `nextPage` cursor in each response to fetch the page after it.

***

## Set the page size

Pass `limit` on any list endpoint to set the maximum number of results per page. The value can be between 1 and 100. The default is 50.

```bash Request 10 items theme={null}
curl https://app.supercycle.com/api/v1/items?limit=10
```

***

## Request the next page

Every list response includes a `nextPage` attribute. Its value is a cursor token for the next page of results. Pass it as the `page` parameter on the same endpoint.

```bash Fetch the next page theme={null}
curl https://app.supercycle.com/api/v1/items?page=d97b06f29a0
```

<Note>
  When `nextPage` is `null`, you've reached the last page.
</Note>