1. API Reference
  2. Conventions
  3. Pagination and filtering
Website
  • API overview
  • API quickstart
  • Authentication
  • Project scoping
  • Requests and responses
  • Pagination and filtering
  • Errors
  • GETList supported database engines
  • POSTList projects
  • POSTCreate a project
  • GETGet a project
  • DELETEDelete a project
  • PATCHUpdate a project
  • POSTCreate a source
  • POSTList sources
  • GETGet source details
  • DELETEDelete a source
  • PATCHUpdate a source
  • POSTCreate secret metadata
  • POSTList secret metadata
  • GETGet secret metadata
  • DELETEDelete secret metadata
  • PATCHUpdate secret metadata
  • POSTCreate a schedule
  • POSTList schedules
  • POSTSummarize schedule statuses
  • GETGet a schedule
  • DELETEDelete a schedule
  • PATCHUpdate a schedule
  • DELETERemove a schedule gate
  • POSTActivate or pause a schedule
  • POSTQueue a manual check
  • POSTCreate an immutable report
  • POSTList reports
  • GETGet report details
  • DELETEDelete a report
  • POSTDownload a report
  • POSTGet the API-key scope catalog
  • POSTCreate an API key
  • POSTList API-key metadata
  • GETGet API-key metadata
  • DELETEDelete an API key
  • PATCHUpdate API-key metadata
  • POSTCreate a notification channel
  • POSTList notification channels
  • POSTResolve notification channels by ID
  • GETGet notification channel details
  • DELETEDelete a notification channel
  • PATCHUpdate a notification channel
  • POSTSend a test notification
  • POSTCreate a project worker
  • POSTList project workers
  • GETGet worker details
  • DELETEDelete a worker
  • PATCHUpdate a worker
  • POSTRead live worker agent logs
  • POSTList checks
  • POSTSummarize check statuses
  • GETGet check details
  • POSTGet check log sections
  • POSTDownload a check log
  • POSTDownload check audit evidence
  • POSTList notification messages
  • GETGet notification message details

Pagination and filtering

Page through RestoreTrust list endpoints with stable cursors, sorting, and resource-specific filters.

Loading documentation…

Requests and responses< PreviousErrorsNext >

Powered by heyo

On this page

Request a pageContinue from a cursorAvailable filters

List endpoints use POST /v1/{resource}/list. Pagination, sorting, project scope, and filters are sent in the JSON body.

Request a page

json
{  "project_id": "65f0c7a9a7d6b4e2c1234567",  "sort": "created-desc",  "pagination": {    "limit": 25  },  "filters": {    "status": "active"  }}
pagination.limitintegeroptional

Number of rows to return. Defaults to 25; minimum 1, maximum 200.

sort"created-asc" | "created-desc"optional

Sorts by creation time. Defaults to created-desc.

filtersobjectoptional

Resource-specific filters. Unknown filter keys return 400.

Some session-only project lists also support updated-asc and updated-desc. Follow the schema on the generated endpoint page.

Continue from a cursor

When has_more is true, copy both values from next_cursor into the next request:

json
{  "project_id": "65f0c7a9a7d6b4e2c1234567",  "sort": "created-desc",  "pagination": {    "limit": 25,    "after_id": "65f0d012a7d6b4e2c2468101",    "after_value": "2026-09-30T13:45:12Z"  },  "filters": {    "status": "active"  }}
Keep the query stable

Reuse the same sort, filters, and project for every page. Supply after_id and after_value together; sending only one returns 400, as does an after_value without an explicit offset or Z.

Treat cursor values as opaque. Stop when has_more is false; next_cursor is then absent.

For counts across the project, use the check summary or schedule summary. Counting one list page does not give the total. Summary endpoints have their own request fields and do not inherit list filters.

Available filters

Each resource page summarizes useful filters, while the generated operation page is the source of truth:

  • List checks
  • List schedules
  • List sources
  • List reports
  • List messages

Related topics

  • Understand list response envelopes
  • Apply project scope
  • Browse all API resources