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

# Pagination, filtering, sorting

> List endpoint query parameters and pagination response headers.

List endpoints support consistent query parameters for pagination,
filtering, and sorting.

## Pagination parameters

| Parameter | Default / Max |
| - | - |
| `page` · integer | default `1` |
| `perPage` · integer | default `10`, max `1000` |

> [!NOTE]
>
> Pagination metadata is in response headers, not in the body.

Paginated responses carry metadata in HTTP response headers:

| Header | Value |
| - | - |
| `X-Pagination-Current-Page` | Current page number |
| `X-Pagination-Total-Count` | Total items across all pages |
| `X-Pagination-Page-Count` | Total number of pages |
| `X-Pagination-Per-Page` | Page size used for this request |

Example response with headers:

```json theme={null}
{
  "status": "success",
  "code": 200,
  "name": "OK",
  "message": "Affiliates List",
  "info": { "affiliates": [] }
}
```

```
X-Pagination-Current-Page: 2
X-Pagination-Total-Count: 137
X-Pagination-Page-Count: 7
X-Pagination-Per-Page: 20
```

## Sorting

| Parameter | Values |
| - | - |
| `sortField` | endpoint-specific field name |
| `sortDirection` | `asc` (default) \| `desc` |

```
GET /api/v2/network/affiliates?sortField=created_at&sortDirection=desc&page=1&perPage=50
```

## Filtering

| Parameter | Meaning |
| - | - |
| `field=value` | Exact match — e.g. `status=1` |
| `field[]=v1&field[]=v2` | Match any value — e.g. `country[]=US&country[]=GB` |
| `field_from` / `field_to` | Date or numeric range |
| `q` | Full-text search |

## Date format

All date and datetime filters accept ISO 8601. If no timezone is given,
UTC is assumed.

* Date only: `2026-01-20`
* Datetime UTC: `2026-01-20T13:45:00Z`


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