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

# Pagination

> Pagination conventions for OrgX list endpoints.

OrgX Public Preview list endpoints use offset pagination where available.

## Request Parameters

| Parameter | Type    | Default           | Description                        |
| --------- | ------- | ----------------- | ---------------------------------- |
| `limit`   | integer | endpoint-specific | Maximum number of items to return. |
| `offset`  | integer | `0`               | Number of items to skip.           |

Example:

```bash theme={"dark"}
curl "https://useorgx.com/api/client/live/initiatives?limit=20&offset=0" \
  -H "Authorization: Bearer $ORGX_API_KEY"
```

## Response Fields

List endpoints that support pagination return:

```json theme={"dark"}
{
  "initiatives": [],
  "total": 0,
  "pagination": {
    "limit": 20,
    "offset": 0,
    "has_more": false
  }
}
```

| Field                 | Description                               |
| --------------------- | ----------------------------------------- |
| `total`               | Total matching items when available.      |
| `pagination.limit`    | Number of items requested.                |
| `pagination.offset`   | Current offset.                           |
| `pagination.has_more` | Whether another page is likely available. |

## Fetching the Next Page

When `has_more` is true, request the next page by adding `limit` to `offset`.

```text theme={"dark"}
next_offset = pagination.offset + pagination.limit
```

## Client Guidance

* Keep page sizes small for live surfaces.
* Do not assume every endpoint returns `total`.
* Preserve ordering between requests by keeping the same filters and sort.
* Prefer MCP tools for model-facing exploration when pagination details are not
  important to the end user.