Pagination, filtering, sorting

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`

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:

{
  "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

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

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

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