List or long-poll messages
Summaries ordered oldest-first by received_at, at most 100 per response. With wait > 0 the request holds until a matching message arrives (LISTEN/NOTIFY wake, typically < 2 s after SMTP accept) or the window closes.
Request
- Base URL: https://api.mailfixture.com
- URL: https://api.mailfixture.com/v1/inboxes/{id}/messages
- Auth: HTTP bearer
Path parameters
Inbox id.
Query parameters
Only items (messages, SMS, or captured requests) received strictly after this RFC 3339 timestamp. Feed back the last summary's received_at as a cursor — the row carrying that exact timestamp is not repeated.
Filter expression: subject:<term>, from:<term>, or to:<term> select a field; any other input — including a bare term — matches against the subject. Case-insensitive substring match; LIKE wildcards in the term are escaped. to: matches any recipient.
Long-poll window in seconds; default 0 answers immediately. Clamped to 60 — larger values are accepted and treated as 60. The request returns as soon as a matching item arrives; an empty window still answers 200 with an empty list.
Response
Matching messages — empty array when nothing matched within the wait window.
Changes
No recorded changes to this operation across all 1 revision of this API.