Skip to navigation

Verification feed

Every carrier compliance check the organization recorded after a point, oldest first: voice calls, inbound email, outreach, WhatsApp and API. The feed orders by updated_at, the time the check was written; created_at is when it happened, which for a call’s blocks is earlier. Start with updated_since, then pass next_cursor back as cursor while has_more is true. updated_since is widened by 120 seconds and the last page’s cursor may sit up to 120 seconds behind the newest row, so a check committed late is replayed: dedupe by id. A check on a carrier Envoy deliberately never saved (it failed compliance) has no carrier_id; subject_identifier names who was checked.

Authentication: Supports API key and bearer token authentication.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

X-Organization-IDstring or nullOptional

Query parameters

updated_sincedatetime or nullOptional

Start from checks recorded on or after this time, less a 120-second overlap (ISO-8601). Ignored with cursor.

cursorstring or nullOptional

Continue after a previous page’s next_cursor

statusenum or nullOptional
Only this verdict
Allowed values:
carrier_idstring or nullOptionalformat: "uuid"
Only checks on this carrier
limitintegerOptional1-100Defaults to 100
Page size

Response

Successful Response
datalist of objects

Rows in (timestamp, id) order, oldest first

has_moreboolean

True when more rows follow; call again with next_cursor

next_cursorstring or nullOptional

Pass as cursor to continue after the last row returned. Present on every non-empty page, so a caller can store it and resume from exactly here next time. On the last page of a sync it may sit up to 120 seconds behind the newest row, so a row committed late is replayed on the next poll: dedupe by id.

Errors

401
Unauthorized Error
403
Forbidden Error
422
Unprocessable Entity Error
429
Too Many Requests Error