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

# Pagination

> Page through collections with offset or cursor pagination.

Collection endpoints return a page of results plus a `pagination` object describing how to fetch the next one. The Cura API uses two pagination styles depending on the endpoint.

## Offset pagination

The portfolio list uses offset pagination. Pass `limit` (1–100, default 50) and `offset` (default 0). The response reports `hasMore`, derived without a separate count query, so you keep paging while it is `true`.

```bash theme={null}
curl "https://api.cura.inc/portfolio?limit=50&offset=50" \
  -H "Authorization: Bearer cura_your_key_here"
```

```json theme={null}
{
  "data": [{ "id": "c1f2…", "attributes": { "domain": "acme.com" } }],
  "pagination": { "limit": 50, "offset": 50, "hasMore": true }
}
```

## Cursor pagination

Feed endpoints use a time-based cursor, since entries are ordered newest first and new entries arrive continuously. Pass `limit` (1–50, default 20). Each response returns `nextCursor`; pass it back as `cursor` to fetch the next, older page. When there are no more entries, `nextCursor` is `null`.

```bash theme={null}
curl "https://api.cura.inc/feed?limit=20&cursor=2026-05-01T00:00:00.000Z" \
  -H "Authorization: Bearer cura_your_key_here"
```

```json theme={null}
{
  "data": [{ "id": "f9a1…", "attributes": { "type": "fundraise-announcement" } }],
  "pagination": { "limit": 20, "nextCursor": "2026-04-12T09:30:00.000Z" }
}
```

<Tip>
  A cursor points at a moment in time, so it is stable as new entries arrive — paging forward never
  skips or repeats older entries.
</Tip>

## Filtering

Both list styles accept filters under the `filter` key, using bracket syntax in the query string:

<CodeGroup>
  ```bash Portfolio by priority theme={null}
  curl "https://api.cura.inc/portfolio?filter[priority]=high" \
    -H "Authorization: Bearer cura_your_key_here"
  ```

  ```bash Feed by type theme={null}
  curl "https://api.cura.inc/feed?filter[type]=fundraise-announcement" \
    -H "Authorization: Bearer cura_your_key_here"
  ```
</CodeGroup>

Filters combine with pagination — apply a filter and page through the matching results the same way.