Sent History & Delivery Reports
Every SMS you send—whether from the web dashboard or via the HTTP API—is tracked individually per recipient in Sent (Sent Messages, located at /messages).
Understanding SMS Delivery States
Section titled “Understanding SMS Delivery States”Each recipient mobile number in an SMS request generates its own outbound delivery record (SmsOutDelivery) that transitions through the following states:
| UI State Label | Internal State | Meaning |
|---|---|---|
| New | new |
The message has been accepted and queued for asynchronous dispatch. |
| Sent Out | sent (or unknown_delivery) |
The message has been successfully handed off to the telecom carrier and is awaiting the final handset delivery receipt (DLR). |
| Delivered | delivered |
The telecom carrier confirmed that the SMS was delivered to the recipient’s mobile handset. |
| Not Delivered | not_delivered |
The carrier reported that the message could not be delivered (for example, the phone was switched off or out of coverage until the message validity period expired, or the number is disconnected). |
| Processing Error | processing_error / failure |
The message could not be dispatched (for example, due to insufficient account credits, an invalid phone number format, or a duplicate request constraint). |
Searching and Filtering Sent Messages
Section titled “Searching and Filtering Sent Messages”At the top of the Sent Messages (/messages) page, you can combine multiple filters and click Search:
1. Filter by Delivery State Checkboxes
Section titled “1. Filter by Delivery State Checkboxes”Check one or more state boxes to narrow the list to specific outcomes:
- New
- Processing Error
- Sent Out
- Delivered
- Not Delivered
2. Filter by Mobile Number (Mob.Number)
Section titled “2. Filter by Mobile Number (Mob.Number)”Enter a full or partial recipient mobile number in the Mob.Number input box.
3. Filter by Sent Date Range (Sent Date)
Section titled “3. Filter by Sent Date Range (Sent Date)”Click the Sent Date calendar field to select a preset window or custom date/time range:
- Today
- Yesterday
- Last 7 Days
- Last 30 Days
- This Month
- Last Month
- Custom Range
4. Filter by Reference Number (Ref.Number)
Section titled “4. Filter by Reference Number (Ref.Number)”Enter the custom Reference Number (clientRequestId) you assigned when sending the message via the web form or API to view all deliveries belonging to a specific campaign or transaction.
Understanding the Sent Messages Table Columns
Section titled “Understanding the Sent Messages Table Columns”| Column | Description |
|---|---|
| Identifier | Unique UUID of the individual recipient delivery record (sms_out_delivery.id). For simulated messages, this starts with simulation-. |
| Sent Date/Time | Timestamp when the delivery record was created. |
| Sender Id | The alphanumeric label or mobile number used as the sender. |
| Mob.Number | The normalized recipient mobile number (including country dial code). |
| Message | Preview of the SMS text (hover over the cell to read the full body, or ****** if permanently masked). |
| State | Current delivery status (New, Sent Out, Delivered, Not Delivered, or Processing Error). |
| Error | Short error reason if the delivery failed (hover over the cell to view the full diagnostic error description). |
| Reference Number | Your optional custom reference / client_request_id. |
| Credits | The exact number of SMS credits deducted for this delivery. |