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

# Pagination

> Learn how to paginate through large data sets.

Pagination controls the number of rows returned for an API resource response.

One way to request limits and offsets is by using query parameters. For example:

```bash theme={null}
curl "https://integration.getmateo.com/api/v1/contact?limit=15&offset=30"
```

You can use headers to specify the range of rows desired. This request gets the first twenty contacts:

```bash theme={null}
curl "https://integration.getmateo.com/api/v1/contact" -i \
  -H "Range-Unit: items" \
  -H "Range: 0-19"
```

Note that the api may respond with fewer if unable to meet your request.

There is a hard limit of 50 rows per request. If you set the limit to more than 50, the API will still return max 50 rows.