Delivery statuses
Every SMS moves through a few statuses on its way to the phone. This is what each one means.
Statuses
| Status | Final | Meaning |
|---|---|---|
| QUEUED_FOR_SENDING | No | InboxIQ has accepted the message and is about to send it to the network. |
| SENT_AND_PENDING_DELIVERY | No | The network accepted the message and InboxIQ is waiting for its delivery report. |
| DELIVERED | Yes | The network confirmed the message reached the phone. |
| SENT_AND_DELIVERY_FAILED | Yes | The network accepted the message but could not deliver it, for example because the number is not in use or the phone stayed off too long. |
| FAILED_TO_SEND | Yes | The message could not be handed to the network. |
| SENT_AND_DELIVERY_UNKNOWN | Yes | The message was sent but the network never confirmed delivery, so InboxIQ cannot say whether it arrived. |
Lifecycle
- Your request is accepted and the message is
QUEUED_FOR_SENDING. - InboxIQ sends it to the right network and it becomes
SENT_AND_PENDING_DELIVERY. - The network reports back and the message becomes
DELIVEREDorSENT_AND_DELIVERY_FAILED.
If something goes wrong before step 2 the message ends as FAILED_TO_SEND.
Where to see statuses
- Single SMS: the response to Send an SMS shows the first status, and SMS History in the dashboard shows the latest.
- Bulk SMS:Check a batch returns the counts per status, and Bulk Batches in the dashboard shows every message.