# REST API pagination guide

> Use pagination for the Rippling REST API.

Use pagination for the Rippling REST API.

## Overview

Pagination is a method of splitting large sets of API results into smaller chunks (pages), retrieved sequentially using parameters like `limit` and a `cursor` to navigate through them.

List endpoints are always forward paginated (e.g., `GET /users`).

* * *

## Limit

`limit` controls how many results are returned in a single page.

-   Default page size is **50**.
-   Most endpoints allow a maximum of **100**.
-   If the requested value exceeds the endpoint maximum, the API returns a `400` error.

```bash
  'https://rest.ripplingapis.com/users?limit=25' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer UOCgmwb.....'
```

Use smaller limits when testing or debugging to reduce payload size.

* * *

## Cursor

`cursor` is used to fetch the next page of results.

-   Start with a request without cursor.
-   Read the `next_link` value from the response.
-   Use `next_link` as-is to request the next page.
-   Continue until `next_link` is `null`.

Example flow using GET List leave requests:

1.  Initial request: `GET https://rest.ripplingapis.com/leave-requests?filter=...&order_by=created_at desc`
2.  Response includes: `"next_link": "https://rest.ripplingapis.com/leave-requests?cursor=..."`
3.  Request the URL in `next_link` to fetch the next page.

```bash
  'https://rest.ripplingapis.com/users?cursor=cD01ODNmZDg5MDA1ZWQyMzNmOGYxZGY0Zjk%3D&limit=25' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer UOCgmwb.....'
```

Source: https://developer.rippling.com/documentation/rest-api/essentials/pagination

> For the complete documentation index, see [llms.txt](https://developer.rippling.com/llms.txt). Public pages have a Markdown version at the same URL with .md added.