Delivery Lifecycle
The states a message passes through and the valid transitions between them.
A message passes through defined states from acceptance to its final outcome. /sms/status and webhook events report these states. The states below are the documented delivery model the API exposes; operator-level delivery reports are mapped into this model.
| State | Meaning |
|---|---|
| queued | Request accepted; not yet handed to the operator. |
| sent | Message handed to the operator network. |
| delivered | Handset delivery confirmed by the network. |
| failed | Permanent failure / rejected by operator. |
| expired | Not delivered within its validity window. |
Valid transitions
lifecycle
queued -> sent -> delivered
queued -> failed
sent -> failed
sent -> expiredqueued means the request was accepted — it does not mean the SMS was sent. Wait for delivered, failed, or expired for the final outcome.