Skip to main content
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.