List messages
bulksms_list_messagesRead-only
List sent (SENT) and received (RECEIVED) SMS messages, newest first by default. BulkSMS limits the window to the last 7 days unless submission_date_from is given. To page newest-first, pass before_id = the smallest id of the previous page; with sort_order ASCENDING pass after_id = the largest id of the previous page. REST: GET /messages with a filter built from the arguments.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | SENT = outgoing (MT), RECEIVED = incoming replies (MO). | |
| limit | No | Maximum number of messages, default 50. The API may return fewer even if more exist: page with before_id. | |
| after_id | No | Only messages with an id higher than this (newer), for paging with sort_order ASCENDING: pass the largest id of the previous page. | |
| before_id | No | Only messages with an id lower than this (older), for paging. | |
| status_id | No | Filter by full status id, e.g. FAILED.BLOCKED or FAILED.EXPIRED. | |
| sort_order | No | Default DESCENDING (newest first). | |
| status_type | No | Filter by delivery status type. | |
| submission_id | No | Only messages of this submission (the submission.id of a sent message). | |
| user_supplied_id | No | The userSuppliedId you set when sending (SENT messages only). | |
| submission_date_from | No | Only messages submitted at or after this time, ISO 8601 with offset, e.g. 2026-10-01T00:00:00Z. |