Developer documentation

Build with the InboxIQ API

SMS

Delivery statuses

Every SMS moves through a few statuses on its way to the phone. This is what each one means.

Statuses

StatusFinalMeaning
QUEUED_FOR_SENDINGNoInboxIQ has accepted the message and is about to send it to the network.
SENT_AND_PENDING_DELIVERYNoThe network accepted the message and InboxIQ is waiting for its delivery report.
DELIVEREDYesThe network confirmed the message reached the phone.
SENT_AND_DELIVERY_FAILEDYesThe 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_SENDYesThe message could not be handed to the network.
SENT_AND_DELIVERY_UNKNOWNYesThe message was sent but the network never confirmed delivery, so InboxIQ cannot say whether it arrived.

Lifecycle

  1. Your request is accepted and the message is QUEUED_FOR_SENDING.
  2. InboxIQ sends it to the right network and it becomes SENT_AND_PENDING_DELIVERY.
  3. The network reports back and the message becomes DELIVERED or SENT_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.