sms

List or long-poll texts

Summaries ordered oldest-first by received_at, at most 100 per response; summaries include the full text (the body is the message). Long-poll semantics match the email endpoint.

get/v1/phone-numbers/{id}/messages

Request

  • Base URL: https://api.mailfixture.com
  • URL: https://api.mailfixture.com/v1/phone-numbers/{id}/messages
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Phone number id.

Query parameters

sincestring date-time

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.

matchstring

Filter expression: from:<term>, to:<term>, or body:<term>; a bare term (or unknown prefix) matches the body — SMS has no subject. Case-insensitive substring match.

waitinteger

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 texts — empty array when nothing matched within the wait window.

Changes

No recorded changes to this operation across all 1 revision of this API.