Skip to main content
Pre-release — contact your Fortary account team for access.
List endpoints return results one page at a time using cursor-based pagination. Every list response has the same shape: 
{
  "data": [ /* the items for this page */ ],
  "pagination": {
    "limit": 100,
    "nextCursor": "eyJ..."
  }
}
  • data — the items in this page.
  • pagination.limit — the page size in effect for this request.
  • pagination.nextCursor — an opaque cursor for the next page, or null when there are no more results.

​
Fetching the next page

To get the next page, pass the nextCursor value back as the nextCursor query parameter. Repeat until nextCursor is null. 
# First page
curl "https://customer-api.fortary.io/v1/vaults?limit=100" \
  -H "Authorization: Bearer fkc_..."

# Next page — pass the nextCursor from the previous response
curl "https://customer-api.fortary.io/v1/vaults?limit=100&nextCursor=eyJ..." \
  -H "Authorization: Bearer fkc_..."
The cursor is opaque — pass back the exact nextCursor string you received. Don’t parse, decode, or construct it; its internal format is not part of the contract and may change.

​
Page size

Set the page size with the limit query parameter. The default is 100 and the maximum is 500. Requesting more than the maximum is capped at the maximum.

​
No total count

Responses don’t include a total result count. Cursor pagination answers “give me the next page,” and computing an exact total on every query would be expensive at custody scale. To know whether more results exist, check nextCursor: a non-null value means there is another page; null means you’ve reached the end.