SMS Status
You use SMS status values to track outbound messages from creation through final delivery. You review the common outbound sequence below. You also review the final statuses returned after delivery processing ends.
Status for outbound messages
When you send outbound messages, you may see the following status sequence:
| Status | Description |
|---|---|
| QUEUE | You see this status after your request reaches Messangi. You know the message is waiting for processing. |
| DEQUEUED | You see this status when the message leaves the queue. You know the message is moving to the mobile operator. |
| CODE_NOT_ALLOWED | You see this status when the sender is not activated or cannot message the recipient. You contact support to verify the sender. |
| INCOMPLETE | You see this status for segmented messages with pending segment statuses. You get segmented messages after exceeding 160 GSM-7 characters or 70 Unicode characters. |
| BLACKLISTED | You see this status when the recipient phone number is on a blocklist. You know the message was not sent to that number. |
| SEGMENTS_EXCEEDED | You see this status when the message exceeds the permitted segment limit. You keep SMS messages under 1600 characters to avoid this status. |
| EXHAUSTED | You see this status when the retry limit is reached. You know delivery attempts have stopped. |
| SENT | You see this status after Messangi dispatches the message to the mobile operator. This status does not confirm delivery to the recipient device. |
:::info
You see transit states after carrier handoff and before a final outcome. You should eventually see a transit state change to a final status.
:::
Status for completed messages
After sending, you receive one of these final statuses:
| Status | Description |
|---|---|
| ENROUTE | You see this status after the sending system sends the message to the mobile operator. |
| INVALID_ROUTING | You see this status when the destination number or route is invalid. You know the network cannot deliver the message. |
| ACCEPTD | You see this status when the mobile operator accepts the message for delivery. You should not treat this status as delivery confirmation. |
| DELIVRD | You see this status after delivery confirmation from the mobile operator. You know the message reached the recipient device. |
| REJECTD | You see this status when the mobile operator rejects the message. You may need to check the number, phone status, or policy restrictions. |
| UNDELIV | You see this status when the mobile operator cannot deliver the message. You may need to check network issues or recipient number status. |
| EXPIRED | You see this status when the operator cannot deliver the message within the allowed time. You know delivery attempts stopped after the window expired. |
| DELETED | You see this status when the mobile operator removes the message before delivery. |
| UNKNOWN | You see this status when the mobile operator cannot confirm delivery. You may need to check for network communication issues or system errors. |
