List messages in an inbox
Returns message summaries for one inbox, newest first, with cursor pagination. The optional has_otp, subject_contains and from filters are ANDed together; invalid values are ignored gracefully (never a 500). The pagination cursor is bound to the exact filter set, so a cursor minted under one filter cannot be replayed under another.
Request
- Base URL: https://dash.mailsocket.app/api/v1
- URL: https://dash.mailsocket.app/api/v1/inboxes/{id}/messages
- Auth: HTTP bearer
Path parameters
The inbox public ID (e.g. inbox_...).
Query parameters
Page size, 1 to 100. Default 25. A value outside that range (or not an integer) returns 422 validation_error with fields.limit.
Opaque, signed, owner- and filter-bound pagination cursor: only the next_cursor returned by the previous page of the SAME endpoint with the same filter parameters is accepted, for 24 hours. An invalid, tampered, expired or foreign cursor (other endpoint, other filter set, other account) returns 422 validation_error with fields.cursor; start again from the first page. Cursors minted with a filter before 2026-10-14 (secfix-p2p3) are refused the same way.
When true, keep only messages with a non-empty OTP (otp IS NOT NULL and otp != '').
Case-insensitive substring match on the subject. Capped at 200 characters; blank values are ignored.
Case-insensitive substring match on the From header.
true (only read messages) | false (only unread messages) | all (no filter, default). Absent or an unrecognized value behaves like all. The pagination cursor is bound to the exact read value used to mint it; a cursor minted under one value cannot be replayed under another (422 validation_error).
Free-text search: case-insensitive substring match on EITHER the subject OR the From header (OR-composed with each other, AND-composed with every other filter). Capped at 200 characters; blank values are ignored. The pagination cursor is bound to the exact q value used to mint it; a cursor minted under one value cannot be replayed under another (422 validation_error).
Response
A page of message summaries.
Changes
No recorded changes to this operation across all 1 revision of this API.