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

> ## Agent Instructions
> When building application code, use `@naturalpay/sdk` for TypeScript or `naturalpay` for Python.
> When operating Natural directly for a user, use the payments MCP at `https://mcp.natural.com`.
> When searching Natural documentation, use the docs MCP at `https://docs.natural.com/mcp`.
> Use the Natural CLI for terminal and CI automation.
> Use REST only for unsupported languages or when the user explicitly requests raw HTTP.
> Start integration development and testing in the sandbox. Do not use production unless the user explicitly requests it.
> For sandbox requests that require `customerPartyId`, list customers first. Reuse only the intended fixture; otherwise create a customer.
> REST and SDK amounts use integer minor units. Payments MCP amounts use decimal strings with a required currency code.

# Pagination

> Cursor-based pagination for list endpoints

List endpoints page with a cursor. Cursors are opaque strings; don't parse or construct them yourself.

## Parameters

| Parameter | Default | Description |
| - | - | - |
| `limit` | 50 | Number of results per page (1–100) |
| `cursor` | none | Cursor from a previous response's `nextCursor`. Up to 1024 characters; pass it back unchanged |

## Response structure

Every list response includes pagination metadata in `meta`:

```json theme={null}
{
  "data": [...],
  "meta": {
    "pagination": {
      "hasMore": true,
      "nextCursor": "eyJjcmVhdGVkQXQiOi..."
    }
  }
}
```

* **`hasMore`**: `true` if additional results exist beyond this page
* **`nextCursor`**: Pass this as the `cursor` query parameter to fetch the next page. `null` when `hasMore` is `false`.

## Related

* [About the Natural API](/api-reference/about): Response structure and JSON:API format


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