Get message status

Chat identifier. Can be: (1) phone number in E.164 format (e.g., +15551234567), (2) email address, (3) group ID (grp_xxxx), or (4) comma-separated list of phone numbers/emails for multi-recipient group chats (e.g., +15551234567,+15559876543). All values should be URL-encoded.

Unique identifier of the message, prefixed with msg_ (e.g. msg_abc123def456). Returned in the response when you send a message and in inbound message webhooks.

Delivery lifecycle state. pending = persisted and being prepared for dispatch; queued = accepted and waiting to be handed to Apple/the carrier; sent = handed off to Apple/the carrier (protocol resolution happens around here); delivered = a delivery receipt was received; failed = could not be delivered (see error); cancellation_requested = a cancel was requested for a still-queued message (best-effort); cancelled = cancelled before dispatch. Inbound messages are surfaced via webhooks with received; read receipts arrive as a read event.

Transport used to carry the message; never null. pending = accepted and dispatched, wire service not resolved yet (settles within seconds of send); imessage = delivered over iMessage (blue bubble); rcs = delivered over RCS; sms = fell back to SMS/MMS (green bubble); unknown = accepted by the carrier but the wire service could not be resolved before the tracking window closed (see error).