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

# Pagination

> Results come in pages of 25.

Operations that return a list return it **25 items per page**. Pass a 1-based `page` query
parameter for the next page:

```bash theme={null}
curl "https://app.loice.ai/api/v1/lead-search/runs/$RUN_ID?page=2" \
  -H "Authorization: Bearer $LOICE_API_KEY"
```

The page comes back with its position:

```json theme={null}
{
  "data": {
    "run": { "id": "cmf3x0v2b0001abcd", "status": "completed", "deliveredCount": 175 },
    "results": {
      "page": 2,
      "pageSize": 25,
      "totalDelivered": 175,
      "items": []
    }
  }
}
```

* `page` is the page you asked for (default `1`).
* `pageSize` is the number of items per page.
* `totalDelivered` is the number of items in the whole list, so the last page is
  `ceil(totalDelivered / pageSize)`.

Reading a page is free and does not change what the run delivers or bills.


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