Pagination

Overview

List endpoints return paginated responses using cursor-based pagination. This approach provides stable results even when data changes between requests.

How it works

Query parameters

Parameter	Type	Default	Description
`limit`	integer	`10`	Maximum number of items to return per page
`cursor`	string	—	Cursor returned from a previous response
`direction`	string	—	Pagination direction: `NEXT` or `PREVIOUS`
`sortOrder`	string	`DESCENDING`	Sort direction: `ASCENDING` or `DESCENDING`

Response structure

Every list response includes a meta object alongside the data array:

{
  "data": [
    { "id": "acc_001", "type": "CHECKING" },
    { "id": "acc_002", "type": "SAVING" }
  ],
  "meta": {
    "previousCursor": null,
    "nextCursor": "eyJpZCI6ImFjY18wMDIifQ",
    "total": 45
  }
}

Field	Description
`previousCursor`	Cursor to fetch the previous page. `null` on the first page.
`nextCursor`	Cursor to fetch the next page. `null` on the last page.
`total`	Number of items returned in the current page.

Examples

First page:

curl --request GET \
  --url 'https://api.sandbox.tracefinance.com/v1/accounts?limit=10' \
  --header 'Authorization: Bearer <token>'

Next page — pass the nextCursor value as cursor:

curl --request GET \
  --url 'https://api.sandbox.tracefinance.com/v1/accounts?limit=10&cursor=eyJpZCI6ImFjY18wMDIifQ' \
  --header 'Authorization: Bearer <token>'

Iterating through all pages:

cursor = None

while True:
    params = {"limit": 10}
    if cursor:
        params["cursor"] = cursor

    response = client.get("/accounts", params=params)
    data = response.json()

    for item in data["data"]:
        process(item)

    cursor = data["meta"]["nextCursor"]
    if cursor is None:
        break

Getting started

Compliance Requirements

API principles

Webhooks

Journeys

Overview

How it works

Query parameters

Response structure

Examples

​Overview

​How it works

​Query parameters

​Response structure

​Examples

Overview

How it works

Query parameters

Response structure

Examples