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

# Pagination

> Read lists with the pagination parameters defined by each endpoint.

List endpoints document their pagination parameters on their individual reference pages. Send an explicit page size when synchronising data.

## Limit and offset

Endpoints such as [List quotes](/api/reference/get_v1_quotes) accept `limit` and `offset`:

```bash theme={"dark"}
curl 'https://api.printools.io/v1/quotes?limit=50&offset=0' \
  -H "X-API-Key: ${PRINTOOLS_API_KEY}"
```

| Parameter | Meaning                                                       |
| --------- | ------------------------------------------------------------- |
| `limit`   | Requested page size. The service applies its current maximum. |
| `offset`  | Zero-based row offset.                                        |

For a page size of 50, request offsets 0, 50, 100, and so on. Use the endpoint's response schema to locate its collection and any pagination metadata.

Read [Current limits](/api/reference/get_v1_reference_limits) for the page-size maximum. Do not rely on an omitted `limit` to provide a bounded page.

## Cursor pagination

[Catalogue](/api/reference/get_v1_catalogue) accepts a `cursor`. Follow the continuation value returned by the API rather than constructing one yourself. Keep the same filters as you advance through the catalogue.

## Filters and facets

Each endpoint lists its supported filters. Facet endpoints provide filter values for their corresponding resource lists; they do not replace pagination.