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

# Pagination, filtering, and sorting

> Page through collections and apply validated filters and sort expressions.

List endpoints return `items` and `pagination`.

```json theme={null}
{
  "items": [],
  "pagination": {
    "page": 1,
    "pageSize": 25,
    "total": 0,
    "pageCount": 0,
    "hasNext": false,
    "hasPrevious": false
  }
}
```

`page` is one-based. `pageSize` is capped at 100. Continue while `hasNext` is true; do not infer the next page solely from the number of returned items.

## Customers and accounts

Customer and account lists use field operators in the query key:

```http theme={null}
GET /v1/accounts?status:in=active,frozen&balance:gte=100000&sort=-createdAt,name
```

Supported operators are `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`, `contains`, and `isNull`, but each field exposes only its allowed subset. Omitting an operator means `eq` when equality is supported. Up to three comma-separated sort fields are accepted; prefix a field with `-` for descending order.

Unknown fields, unsupported operators, and invalid values return `validation_failed`. Filters are never silently ignored.

## Transfers and transactions

Transfer and transaction lists use explicit query fields rather than the generic operator syntax. For example:

```http theme={null}
GET /v1/transfers?status=pending&sourceCurrency=NGN&sort=-createdAt
GET /v1/transactions?accountId=01K2Z3AB4D5E6F7G8H9JKMNPQR&category=transfer
```

See each operation in the API reference for its exact filters and sort values.


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