# Pagination (/docs/api/introduction/pagination)

> For the complete documentation index, see [llms.txt](https://docs.tandemcx.ai/llms.txt). Any page on this site can be fetched as Markdown by appending `.md` to its URL.

List endpoints return results in pages so you can iterate through large
collections predictably.

## Query parameters

| Parameter    | Type    | Default | Description                      |
| ------------ | ------- | ------- | -------------------------------- |
| `pageNumber` | integer | `1`     | The 1-based page to return.      |
| `pageSize`   | integer | `100`   | Items per page (maximum `1000`). |

```bash
curl "https://api.tandemcx.ai/v1/workflows?pageNumber=2&pageSize=50" \
  -H "Authorization: Bearer <token>"
```

## Response shape

Paginated responses wrap the items in `data` and include paging metadata:

```json
{
    "data": [/* items for this page */],
    "pageNumber": 2,
    "pageSize": 50,
    "pageCount": 7,
    "totalCount": 340
}
```

| Field        | Description                             |
| ------------ | --------------------------------------- |
| `data`       | The items on the current page.          |
| `pageNumber` | The page that was returned.             |
| `pageSize`   | The page size that was applied.         |
| `pageCount`  | Total number of pages available.        |
| `totalCount` | Total number of items across all pages. |

## Iterating

Start at `pageNumber=1` and request successive pages until `pageNumber` reaches
`pageCount`.