Pagination and Filtering

Most list endpoints use standard query filters and return list metadata in meta.

Pagination shape

JSON

{
  "data": [],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 95,
    "total_pages": 5
  }
}

Common list query parameters

Many list endpoints support:

• page
• limit
• date_from
• date_to
• status

Some also support lookup filters such as:

• id
• uid
• reference
• trx_id
• email
• search

Date normalization

When a page supports date_from and date_to, date-only values are normalized to full-day boundaries:

• date_from=2026-07-08 becomes 2026-07-08 00:00:00
• date_to=2026-07-08 becomes 2026-07-08 23:59:59

Single-item fetch behavior

Many list endpoints switch into single-item mode when a unique identifier is supplied, for example:

• id
• uid
• reference
• trx_id

In those cases, the endpoint usually returns one object in data instead of a paginated list.