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

# Pagination

> Page numbers, not cursors.

List endpoints take `?page=`, starting at 1:

```bash theme={null}
curl "https://app.huechat.ai/core/accounts/$ACCOUNT_ID/conversations?status=open&page=2" \
  -H "Authorization: Bearer $HUECHAT_TOKEN"
```

Page size is fixed per resource. Conversations return 25 per page; contacts
also accept `?per_page=` and answer with a `meta` block:

```json theme={null}
{
  "meta": { "current_page": 2, "per_page": 25, "count": 143 },
  "payload": [ ... ]
}
```

Keep paging until a page comes back with fewer items than the page size.

<Note>
  Older v1 resources wrap the list in `payload`; some v2 resources return the
  array directly. The response schema on each endpoint page shows which.
</Note>