Messaging Statuses
SMS and campaign lifecycle statuses, detailed delivery reasons, and how final states are reached.
Every SMS and bulk messaging campaign moves through a defined lifecycle. Routee reports progress as statuses — delivered to your app via callbacks or when you poll tracking endpoints.
SMS lifecycle
Queued → Sent → Delivered· final | Undelivered· final | Failed· final | Unsent· final
A final status ends the lifecycle for that message. After a final status, no further transitions occur.
SMS statuses
| Status | Description |
|---|---|
| Queued | Initial status. Routee has received your request and the SMS is about to be sent. |
| Sent | The SMS was sent to the carrier but delivery has not been confirmed yet. |
| Delivered· final | The SMS was delivered to the recipient handset. |
| Undelivered· final | Routee received a delivery receipt indicating the message was not delivered. This can happen due to carrier filtering, handset availability, and other network conditions. |
| Failed· final | Routee was unable to process or send the SMS. |
| Unsent· final | The SMS was not sent due to insufficient balance. Applies only to [Bulk SMS](/reference/send-bulk-messages). |
Detailed status
When an SMS is Undelivered, Routee also returns a detailed status explaining why.
| Detailed status | Description |
|---|---|
| Undelivered on Handset | The destination handset is switched off or otherwise unavailable. |
| Unknown Number | The destination number is unknown and may no longer exist. |
| Roaming | The destination number is roaming and cannot accept the message. |
| Call Barred | The destination number is blocked from receiving this message. |
| Unknown Status | Undelivered for an unknown reason. |
| Carrier Violation | The carrier flagged the message as objectionable (content or spam filtering). |
| Expired | TTL validity period expired after multiple delivery retries. |
India-specific detailed statuses
| Detailed status | Description |
|---|---|
| DND Error Code | Active Do Not Disturb service. |
| Sender ID Error Code / Template Error Code | Sender ID or content is not registered. |
| Memory Capacity Exceeded | Handset memory is full. |
| Quiet Hours | Promotional messages blocked after 9 PM. |
Campaign lifecycle
Scheduled → Queued → Running → Sent → Finished· final | Failed· final
| Status | Description |
|---|---|
| Scheduled | The campaign is scheduled to run in the future. Applies only when you schedule a campaign. |
| Queued | The campaign is queued and its individual SMS messages are about to be sent. |
| Running | The campaign is running. Routee is sending all individual SMS. Duration depends on recipient count. |
| Sent | All individual SMS were sent. Routee is waiting for each message's delivery status. |
| Finished· final | Routee has received the final status for every individual SMS in the campaign. |
| Failed· final | Routee was unable to process the campaign (or part of it). |
Campaign status vs SMS status
A bulk messaging campaign has its own lifecycle, but each SMS it creates also has its own SMS status lifecycle described above.
Related
Updated 13 days ago