Messages
Get Message
Retrieve details of a specific SMS message
POST
Get detailed information about a message, including its delivery status.
Request Body
string
required
The unique identifier of the message to retrieve.
Response
string
Unique message identifier.
string
Associated contact identifier, or
null.string
Stable identifier for the conversation this message belongs to. Deterministic — every inbound and outbound message between the same contact and service number shares the same
thread_id, regardless of direction or phone-number formatting. Use it to group messages into threads.string
The sending phone number.
string
The recipient phone number.
string
The message content.
string
Either
inbound or outbound.string
Message status:
pending, sent, delivered, undelivered, or failed.boolean
Whether this message was generated by the AI agent.
string
ISO 8601 timestamp when the message was sent.
string
ISO 8601 timestamp when the message was created.
string
Carrier message SID for tracking, or
null.string
ISO 8601 timestamp when delivery was confirmed, or
null.string
Detected sentiment:
positive, neutral, negative, or null.string
Agent that generated the message, or
null.string
Translated message content, or
null.array
Attachments on the message (inbound WhatsApp photos, voice notes, video, documents). Empty array when there are none. Each URL is freshly signed on every request and valid for 24 hours — re-fetch the message to get a new link rather than persisting the URL.
object
Present (non-
null) only when status is failed or undelivered. Explains why the provider rejected delivery — works for both WhatsApp (Meta) and SMS (SignalWire).