Pagination - Secfix Developers

List endpoints return an opaque, cursor-paginated envelope. Cursors are signed and opaque — do not parse or construct them; pass back exactly what the API returned.

Query parameters

Parameter	Description	Default
`pageSize`	Number of results per page (1–100).	25
`pageCursor`	Opaque cursor from the previous page’s `pageInfo.endCursor`.	—

Response envelope

{
  "results": [ /* ... */ ],
  "pageInfo": {
    "hasNextPage": true,
    "endCursor": "eyJjIjoiMjAyNi0wNi0zMFQwMjowMDowMFoiLCJyIjoiM2YxYzlhMmUifQ..",
    "totalCount": 1284
  }
}

Field	Description
`hasNextPage`	`true` if more results remain after this page.
`endCursor`	Opaque cursor for the next page. Omitted when `hasNextPage` is `false`.
`totalCount`	Total number of results matching the query across all pages.

Iterating

Fetch the first page, then keep passing pageInfo.endCursor as pageCursor while pageInfo.hasNextPage is true:

# first page
curl "https://api.secfix.com/v1/inventory/assets?pageSize=50" \
  -H "Authorization: Bearer $TOKEN"

# next page
curl "https://api.secfix.com/v1/inventory/assets?pageSize=50&pageCursor=eyJj..." \
  -H "Authorization: Bearer $TOKEN"

When hasNextPage is false, endCursor is omitted and you have read every result.