Pagination

All Nuvion list endpoints return paginated results using cursor-based pagination. Each response includes a data.meta.pagination object with cursors pointing to the previous and next pages.

Request parameters

Pass these as query parameters on any list endpoint.

integer

Number of records to return. Between 1 and 100. Defaults to 20.

string

Pagination cursor from a previous response. Omit for the first page.

Response envelope

All Nuvion responses share a standard envelope. List endpoints return the records under data.data, with pagination state under data.meta.pagination.

{
  "status": "success",
  "message": "Accounts retrieved successfully",
  "data": {
    "data": [
      {
        "entity_id": "01HXYZ2345ABCDEFGHJKMNPQRS",
        "type": "checking",
        "currency": "NGN",
        "display_name": "Main NGN Account",
        "config": {
          "is_overdraftable": false,
          "overdraft_limit": 0
        },
        "nuvion_ban": "NVXYT1GUCM",
        "created": 1761820364358,
        "updated": 1784718768076,
        "balance": {
          "current": 104727,
          "available": 104727,
          "overdraft_used": 0
        },
        "id": "01HXYZ9012ABCDEFGHJKMNPQRS",
        "status": "active"
      }
    ],
    "meta": {
      "pagination": {
        "order": "asc",
        "has_next": true,
        "limit": 1,
        "has_previous": false,
        "next_cursor": "01HXYZ9012ABCDEFGHJKMNPQRS",
        "previous_cursor": null
      },
      "filters_applied": {
        "parent_account_id": null,
        "entity_id": "01HXYZ2345ABCDEFGHJKMNPQRS",
        "type": {},
        "sort": {
          "field": "created",
          "order": "asc"
        }
      }
    }
  }
}

array

The list of objects for the current page.

integer

The number of records requested per page.

string

Sort order applied to the results. One of asc or desc.

boolean

true if there are more records after this page. false on the last page.

boolean

true if there are records before this page. false on the first page.

string | null

Value to pass as cursor to fetch the next page. null when has_next is false.

string | null

Value to pass as cursor to fetch the prior page. null when has_previous is false.

object

The active filters applied to the query, reflected back in the response.

Example: iterate through pages

curl "https://api.nuvion.dev/transfers?limit=20" \
  -H "Authorization: Bearer $NUVION_API_KEY"

curl "https://api.nuvion.dev/transfers?limit=20&cursor=01HXYZ9012ABCDEFGHJKMNPQRS" \
  -H "Authorization: Bearer $NUVION_API_KEY"

Always check has_next before requesting the next page rather than testing for a non-null next_cursor: this is the authoritative signal that more records exist.

Get Started

Core Concepts

Webhooks

Guides

Request parameters

Response envelope

Example: iterate through pages

​Request parameters

​Response envelope

​Example: iterate through pages

Request parameters

Response envelope

Example: iterate through pages