1. API Reference
  2. Messages
  3. List notification messages
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
POST/messages/list

List notification messages

Returns a cursor-paginated page of notification delivery records from the requested project.

Send request

Use the documented inputs to call this endpoint directly.

API serverbase URL

Request body

application/jsonrequired

Responses

200application/json

Message page.

{
  "status": "success",
  "data": {
    "messages": [
      {
        "id": "65f0c7a9a7d6b4e2c1234567",
        "org_id": "65f0c7a9a7d6b4e2c1234567",
        "status": "queued",
        "kind": "check",
        "detail": "string",
        "check_id": "",
        "schedule_id": "",
        "schedule_name": "string",
        "channel_id": "",
        "channel_name": "string",
        "retry_count": 1,
        "created_at": "2026-01-01T00:00:00Z",
        "updated_at": "2026-01-01T00:00:00Z",
        "sent_at": "2026-01-01T00:00:00Z"
      }
    ]
  },
  "pagination": {
    "limit": 1,
    "has_more": true,
    "next_cursor": {
      "after_id": "65f0c7a9a7d6b4e2c1234567",
      "after_value": "2026-01-01T00:00:00Z"
    },
    "filter_scan_truncated": true
  },
  "sort": "string",
  "filters": {
    "channel_id": "65f0c7a9a7d6b4e2c1234567",
    "check_id": "65f0c7a9a7d6b4e2c1234567",
    "status": "queued",
    "kind": "check"
  }
}
400application/json

The request body, parameter, filter, cursor, or project-scoping pattern is invalid.

{
  "status": "error",
  "message": "string",
  "code": "string",
  "detail": {},
  "quota": {
    "key": "string",
    "limit": 1,
    "used": 1
  },
  "feature": "string",
  "dependency": "string"
}
statusstringrequired
messagestringrequired
codestringoptional

Stable machine-readable code when the error defines one.

detailobjectoptional
quotaoptional
featurestringoptional
dependencystringoptional
401application/json

Authentication is missing or the credential is invalid, inactive, expired, or lacks the required scope.

{
  "status": "error",
  "message": "string",
  "code": "string",
  "detail": {},
  "quota": {
    "key": "string",
    "limit": 1,
    "used": 1
  },
  "feature": "string",
  "dependency": "string"
}
statusstringrequired
messagestringrequired
codestringoptional

Stable machine-readable code when the error defines one.

detailobjectoptional
quotaoptional
featurestringoptional
dependencystringoptional
403application/json

The authenticated caller is not allowed to perform this operation.

{
  "status": "error",
  "message": "string",
  "code": "string",
  "detail": {},
  "quota": {
    "key": "string",
    "limit": 1,
    "used": 1
  },
  "feature": "string",
  "dependency": "string"
}
statusstringrequired
messagestringrequired
codestringoptional

Stable machine-readable code when the error defines one.

detailobjectoptional
quotaoptional
featurestringoptional
dependencystringoptional
Download check audit evidence< PreviousGet notification message detailsNext >

Powered by heyo

curl --request POST \  '/v1/messages/list' \  --header 'Content-Type: application/json' \  --data '{  "project_id": "65f0c7a9a7d6b4e2c1234567",  "sort": "created-desc",  "pagination": {    "limit": 25,    "after_id": "65f0c7a9a7d6b4e2c1234567",    "after_value": "2026-01-01T00:00:00Z"  },  "filters": {    "channel_id": "65f0c7a9a7d6b4e2c1234567",    "check_id": "65f0c7a9a7d6b4e2c1234567",    "status": "queued",    "kind": "check"  }}'
{  "status": "success",  "data": {    "messages": [      {        "id": "65f0c7a9a7d6b4e2c1234567",        "org_id": "65f0c7a9a7d6b4e2c1234567",        "status": "queued",        "kind": "check",        "detail": "string",        "check_id": "",        "schedule_id": "",        "schedule_name": "string",        "channel_id": "",        "channel_name": "string",        "retry_count": 1,        "created_at": "2026-01-01T00:00:00Z",        "updated_at": "2026-01-01T00:00:00Z",        "sent_at": "2026-01-01T00:00:00Z"      }    ]  },  "pagination": {    "limit": 1,    "has_more": true,    "next_cursor": {      "after_id": "65f0c7a9a7d6b4e2c1234567",      "after_value": "2026-01-01T00:00:00Z"    },    "filter_scan_truncated": true  },  "sort": "string",  "filters": {    "channel_id": "65f0c7a9a7d6b4e2c1234567",    "check_id": "65f0c7a9a7d6b4e2c1234567",    "status": "queued",    "kind": "check"  }}