Pagination, filtering, and sorting

List endpoints return items and pagination.

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

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:

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.

Getting Started

Platform Guides

Currencies and countries

Customers

Accounts

Recipients and destinations

Transfers

Cards

Bill payments

eSIM

Tutorials

Webhooks

Pagination, filtering, and sorting

Customers and accounts

Transfers and transactions

​Customers and accounts

​Transfers and transactions

Customers and accounts

Transfers and transactions