List sent and received messages
smsmode_list_messagesRead-only
Messages with delivery status (SCHEDULED, ENROUTE, DELIVERED, UNDELIVERABLE, UNDELIVERED; status.detail names the cause), recipient, sender, text, parts and price. Default window: the last 10 days. Filter by direction (MT = sent, MO = replies received), recipient, your reference, channel or campaign. Paged: pass next_page as page. GET /sms/v1/messages.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Only messages to/from this number (international digits, e.g. 33610203040). | |
| page | No | Page number, 1-based (default 1). Use next_page from the previous reply. | |
| end_date | No | Window end (default now) | |
| direction | No | MT = sent messages (default), MO = incoming replies. | |
| page_size | No | Results per page, 1-100 (default 10). | |
| channel_id | No | Only this channel. | |
| ref_client | No | Only messages tagged with this reference. | |
| start_date | No | Window start (yyyy-mm-dd or yyyy-mm-ddThh:mm:ss; default 10 days ago) | |
| campaign_id | No | Only this campaign (from smsmode_list_campaigns). | |
| origin_message_id | No | Only replies to this message (direction MO is set automatically). | |
| sort_by_sent_date | No | Order by sent date. |