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

# Pagination

> Work through long lists one page at a time.

List endpoints return one page at a time. You move between pages with a cursor.

## Parameters

| Parameter | Description |
| - | - |
| `limit` | Items per page, 1–100. Default 10. |
| `cursor` | The `next_cursor` from the previous page. Leave it out for the first page. |
| `prev_cursor` | The `prev_cursor` from the current page, to go back one page |
| `order` | `ASC` or `DESC`, on edition and protocol lists. `DESC` returns the newest first. |

For example, to list the employees of a UK organization 100 at a time:

```bash Request theme={null}
curl --request GET \
  --url 'https://preview.intermezzo.ai/gb/organizations/{organization_id}/employees?limit=100' \
  --header 'Authorization: Bearer <access_token>'
```

```json Response theme={null}
{
  "items": [
    { "id": "emp_…", "external_ref": "EMP-100234", "…": "…" }
  ],
  "pagination": {
    "limit": 100,
    "has_next": true,
    "has_prev": false,
    "next_cursor": "…",
    "prev_cursor": null,
    "total": 274
  }
}
```

## Response

* `has_next` says whether there is a later page. Request it with `cursor` set to `next_cursor`.
* `has_prev` says whether there is an earlier page. Request it with `prev_cursor`.
* `total` is the number of items across all pages.

Treat cursors as opaque strings: don't build or change them.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.