Messages (v2)
List Messages
List and filter sent messages, with cursor pagination and an updated_since reconciliation watermark.
GET
Lists messages for the account the key belongs to. By default rows are returned newest-first for browsing. Pass
updated_since to turn the endpoint into an incremental reconciliation feed.
Query Parameters
integer
Filter to one sending list by its ID.
string
Filter by sending-list phone number (E.164). Ignored when
sending_list_id is set; an unmatched number returns zero rows.string
Filter by recipient phone number (E.164).
string
One of
queued, sent, failed, dropped, orphaned, delivered, undelivered.string
Lower bound on
timestamp (ISO-8601, timezone-aware — include Z or an offset). A naive datetime is rejected.string
Upper bound on
timestamp (ISO-8601, timezone-aware).string
Reconciliation watermark (ISO-8601, timezone-aware). When set, returns rows with
updated_at greater than this value, sorted oldest-change-first and keyset-paginated on (updated_at, id). See Reconciliation.string
Scope results to an owned account (yourself or a child) carrying this external location ID. An unowned location returns an empty result, never another tenant’s data.
string
Opaque pagination cursor from a previous response’s
next_cursor.integer
default:"50"
Page size, max 200.
Response Fields
array
Array of message rows.
object
limit, has_more (boolean), and next_cursor (opaque, null on the last page).Examples
Error Codes
Also
401 invalid_credentials.
Next Steps
Reconciliation
Keep a local mirror in sync with the watermark.
Get a message
Fetch a single message by ID.