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

# Pagination

> Cursor-based pagination on list endpoints.

List endpoints return an opaque, cursor-paginated envelope. Cursors are signed and opaque — do not
parse or construct them; pass back exactly what the API returned.

## Query parameters

| Parameter    | Description                                                  | Default |
| ------------ | ------------------------------------------------------------ | ------- |
| `pageSize`   | Number of results per page (1–100).                          | 25      |
| `pageCursor` | Opaque cursor from the previous page's `pageInfo.endCursor`. | —       |

## Response envelope

```json theme={null}
{
  "results": [ /* ... */ ],
  "pageInfo": {
    "hasNextPage": true,
    "endCursor": "eyJjIjoiMjAyNi0wNi0zMFQwMjowMDowMFoiLCJyIjoiM2YxYzlhMmUifQ.."
  }
}
```

## Iterating

Fetch the first page, then keep passing `pageInfo.endCursor` as `pageCursor` while
`pageInfo.hasNextPage` is `true`:

```bash theme={null}
# first page
curl "https://api.secfix.com/v1/inventory/assets?pageSize=50" \
  -H "Authorization: Bearer $TOKEN"

# next page
curl "https://api.secfix.com/v1/inventory/assets?pageSize=50&pageCursor=eyJj..." \
  -H "Authorization: Bearer $TOKEN"
```

When `hasNextPage` is `false`, `endCursor` is omitted and you have read every result.