List Messages
Authentication
AuthorizationBearer
Your RRay API key.
OR
RRay-Workspace-Idstring
The workspace to act on. Required when your credential is account-level; ignored for workspace-scoped API keys, which already carry their workspace.
Query parameters
id
Return the message with this exact id (the id returned by POST /v1/messages).
status
Only return messages whose aggregate status is one of these. Repeat the param for several (status=queued&status=delivered).
recipient
Only return messages addressed to this exact address on any channel (to, cc, or bcc).
created_at
Filter by creation time (RFC 3339). Pass 1 or 2 values:
- **Two values** → an inclusive range; order does not matter (`created_at=2026-07-01T00:00:00Z&created_at=2026-07-31T23:59:59Z`).
- **One full timestamp** → exact match (`created_at=2026-07-12T09:30:00Z`).
- **One date, no time** → that whole calendar day (`created_at=2026-07-12`).
Include a timezone offset for local-time filtering (`2026-07-12T00:00:00+07:00`); a value without an offset is interpreted as UTC. To show a user's day in their timezone, send the two local-day boundaries with their offset.
limit
Rows per page (1–100, default 20).
cursor
Opaque pagination token. Omit for the first page (newest rows first). To page, copy `pagination.next_cursor` (older rows) or `pagination.prev_cursor` (newer rows) from the previous response into this parameter — do not build it yourself: the walk direction and the active filter set are encoded in the token, and reusing a cursor with a different filter set is rejected (`validation.cursor_filters_mismatch`).
Response
Successful Response
data
pagination
total/total_capped are present on the entry page only (no COUNT
is executed while walking cursors).
object
Errors
400
Bad Request Error
401
Unauthorized Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error