> This page is for Multi-Tenant, version v3.0 (default).
> For other versions, use one of these documentation indexes:
> - v3.0 (default): https://docs.nvidia.com/run-ai/multi-tenant/v3.0/llms.txt
> - v2.26: https://docs.nvidia.com/run-ai/multi-tenant/v2.26/llms.txt
> - v2.25: https://docs.nvidia.com/run-ai/multi-tenant/v2.25/llms.txt
> - v2.24: https://docs.nvidia.com/run-ai/multi-tenant/v2.24/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/run-ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/run-ai/_mcp/server.

# Pagination

Several List endpoints in the NVIDIA Run:ai control plane API return large collections. To retrieve results in smaller chunks, use offset/limit pagination.

## How Pagination Works

### Request Parameters

When an endpoint supports pagination, it typically exposes:

* `limit` - Maximum number of items to return (default 50, range 1..500)
* `offset` - The offset of the first item returned in the collection

Example: `GET /api/v1/authorization/access-rules?offset=0&limit=50`

### Pagination Response

List responses may include a `next` field, alongside the collection itself.

Example response shape:

```json
{
  "next": 1,
  "roles": [ ... ]
}
```

Use `next` as the pointer for retrieving the next page of results. If `next` is not returned (or is empty), you have reached the end of the collection.

### Example: Paginate Through Results

#### Fetch the first page

```bash
curl -sS \
  -H "Authorization: Bearer <TOKEN>" \
  "https://console.<DOMAIN>/api/v2/authorization/roles?offset=0&limit=50"
```

#### Fetch the next page

Take the `next` value from the response and use it as the offset in the next request.

### Combine Pagination with Sorting and Filtering

List endpoints also support:

* **Sorting** - `sortBy` and `sortOrder`
* **Structured filtering** - `filterBy` with operators like `==`, `!=`, `>=`, `=@` (contains), etc.
* **Free-text search** - `search`

Example:

```bash
curl -sS \
  -H "Authorization: Bearer <TOKEN>" \
  "https://console.<DOMAIN>/api/v2/authorization/roles?limit=100&offset=0&sortBy=createdAt&sortOrder=desc&filterBy=allocatedGPU>=2"
```