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

​
Request parameters

Pass these as query parameters on any list endpoint.
​
limit
integer
Number of records to return. Default: 20. Maximum: 20.
​
next_cursor
string
Cursor pointing to the next page. Pass the value of meta.pagination.next_cursor from the previous response.
​
previous_cursor
string
Cursor pointing to the prior page. Pass the value of meta.pagination.previous_cursor from the previous response.

​
Response envelope

All list endpoints wrap their results in a standard envelope: 
{
  "message": "success",
  "status": "success",
  "data": {
    "data": [ ],
    "meta": {
      "pagination": {
        "limit": 20,
        "total_count": 84,
        "has_next": true,
        "has_previous": false,
        "next_cursor": "01HXYZ9012MNOP",
        "previous_cursor": null
      },
      "filters_applied": {}
    }
  }
}
​
data.data
array
The list of objects for the current page.
​
data.meta.pagination.limit
integer
The number of records requested per page.
​
data.meta.pagination.total_count
integer
Total number of records matching the query across all pages.
​
data.meta.pagination.has_next
boolean
true if there are more records after this page. false on the last page.
​
data.meta.pagination.has_previous
boolean
true if there are records before this page. false on the first page.
​
data.meta.pagination.next_cursor
string | null
Cursor to pass as next_cursor to fetch the next page. null when has_next is false.
​
data.meta.pagination.previous_cursor
string | null
Cursor to pass as previous_cursor to fetch the prior page. null when has_previous is false.
​
data.meta.filters_applied
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"
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.