---
title: "Cursor pagination"
description: "Forward opaque server cursors and optional page sizes without decoding or rewriting them."
---

> Documentation Index
> Fetch the complete documentation index at: https://nexus.microvoid.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor pagination

Cursor values are opaque strings owned by the Admin API. Store and return them unchanged.

```ts
import { cursorPage } from '@nexus/sdk-typescript';

const page = cursorPage('opaque-server-cursor', 20);
const usage = await nexus.listUsageEvents({
  path: { workspaceId },
  query: page,
});
```

`cursorPage(cursor, limit)` omits either property when it is `undefined`. It does not decode, validate, sign, or alter the cursor and does not automatically fetch subsequent pages.

Source: https://nexus.microvoid.io/management-sdk/cursor-pagination/index.mdx