Export messages
Streams matching SMS and MMS messages as newline-delimited JSON (NDJSON), one message per line, for bulk export.
Query parameters
Returns messages sent on or after this timestamp, in YYYY-MM-DDTHH:MM:SS format.
Returns messages sent on or before this timestamp, in YYYY-MM-DDTHH:MM:SS format.
Filters messages by direction. One of inbound (messages received by the account) or outbound (messages sent by the account).
Filters by message sender. For outbound messages, the Sender ID used to send the message; for inbound messages, the originating phone number.
Filters by message recipient. For outbound messages, the destination phone number; for inbound messages, the SMS-enabled number that received the message.
Current delivery status of the message. One of:
- accepted — the message was accepted by the platform for sending.
- pending — the message is queued and awaiting a carrier response.
- sent — the message was handed to the carrier.
- delivered — the carrier confirmed delivery to the handset.
- undelivered — the carrier reported that delivery failed.
- expired — the validity period elapsed before the message was sent.
- rejected — the message was rejected before sending.
- dlr_expired — no delivery receipt arrived from the carrier within the expected window.
Filters messages by delivery status. Accepts a MessageDeliveryStatus value.
Filters messages by tag. Supported for outbound messages only.
Filters messages by type. One of sms (text message) or mms (multimedia message).
Response
Returns an NDJSON stream of messages, one per line.