---
updatedAt: 2026-03-18T08:42:29.000Z
agentTools:
  projectIndex: https://docs.budibase.com/llms.txt
---

# REST pagination

Configure paginated REST queries for table/repeater data

Use pagination when an API returns list data in pages and you need reliable forward/backward navigation in app components.

## Before you start

1. Create and save a REST connection
2. Create and validate a list query
3. Confirm which pagination model the API uses

## Pagination models

| Model        | Typical request fields | Typical response fields         |
| :----------- | :--------------------- | :------------------------------ |
| Page number  | `page`, `limit`        | `totalPages`, `page`, `hasNext` |
| Offset/limit | `offset`, `limit`      | `total`, `offset`, `count`      |
| Cursor       | `cursor`, `limit`      | `nextCursor` or bookmark token  |

## Configure query pagination

1. Open query in API Editor
2. Enable pagination
3. Select pagination type and location
4. Map request field names
5. Map response field path for continuation token/page value
6. Click **Send** repeatedly to validate progression
7. Save query

## Cursor-specific guidance

* Map to the API field that returns the **next** cursor token
* Verify token comes from raw response path expected by Budibase
* Ensure stable sort order to avoid duplicates/missed rows

## Use paginated query in components

1. Bind query (or data provider) to table/repeater
2. Enable component pagination controls where applicable
3. Validate first, next, previous, and final page behavior

## Troubleshooting matrix

| Symptom                     | Likely cause                         | Fix                            |
| :-------------------------- | :----------------------------------- | :----------------------------- |
| Always shows page 1         | Request page/cursor field not mapped | Re-check request field mapping |
| Stops after first page      | Response continuation path incorrect | Correct response field path    |
| Duplicate rows across pages | Non-deterministic API sorting        | Add stable sort in API query   |
| Missing rows                | Offset/page-size mismatch            | Verify API math and defaults   |

## Related guides

* [REST queries](https://docs.budibase.com/docs/rest-queries)
* [REST variables](https://docs.budibase.com/docs/rest-variables)