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

# Pagination

> Cursor pagination on list endpoints.

List endpoints return an `items` array and pagination metadata:

```json theme={null}
{
  "items": [],
  "metadata": {
    "count": 0,
    "nextCursor": "opaque-value"
  }
}
```

* `count` is the number of items in the current response.
* `nextCursor` is present when another page is available.
* An omitted `nextCursor` means the current page is the last page.

Pass `nextCursor` back as the next request's `cursor` query parameter:

```bash theme={null}
curl --get "https://api.slash.com/v2/contacts" \
  -H "X-API-Key: ${SLASH_API_KEY}" \
  -H "x-legal-entity: ${SLASH_LEGAL_ENTITY_ID}" \
  --data-urlencode "cursor=${NEXT_CURSOR}"
```

Treat cursors as opaque strings. Do not decode, modify, or construct them.
When paging through a filtered collection, keep the same filters on every
request and add only the cursor returned by the preceding page.

<Note>
  List endpoints choose their own page size; the API does not expose a page-size
  parameter. Process every item and continue until `nextCursor` is absent.
</Note>