Message Statuses

Message statuses are provided at different points in a message's journey:

1. The initial send to the carrier provides a basic status.
2. Status updates may occur while the message is in transit through carrier networks.
3. A final status may be received when the message arrives at the destination.

Multiple receipts can be received for the same message while it is in transit.

Status	Description
Received	Received by DIY Surveys to process. It may not yet have been processed because DIY Surveys is waiting for the carrier to respond, or the Windows and When parameters do not allow the message to be sent yet.
Sent	The message was sent to the carrier.
Timedout	The message was sent but there was no reply based on the timeout value.
Delivered	The message was successfully delivered to the destination.
Blocked	The destination was blocked by the carrier.
Blacklisted	The destination was blacklisted by the carrier.
Failure	There was a problem submitting to the carrier.
LandlineUnknown	The number is associated with a landline or is unknown and should not be used.
NoRoute	DIY Surveys cannot find a suitable route for this message. Contact DIY Surveys Support.
Killed	The number was killed from further activity if it was queued for sending.
Notkilled	The number was not killed because the message may already have been sent.
Queued	The message has been queued and is awaiting confirmation of submitted or failure status.
Submitted	The message has been submitted to the network for delivery.
InvalidSourceNumber	The source number is unsuitable for this message.
InvalidDestinationNumber	The destination number does not match a recognised destination format.
BufferedForRetry	The message is being buffered while another attempt is carried out.
Busy	The destination device is unable to accept the message because it is busy.
InternalFailure	DIY Surveys could not process the message due to an internal failure.
Unknown	DIY Surveys could not establish the status from a malformed or unclear receipt.
Unrouteable	The number was incorrect or the carrier could not route to it.
Undelivered	The message was undelivered for a non-specific SMS network reason.
Expired	The message took too long to process by carriers and expired.
Rejected	The message was rejected by the recipient.
InvalidReceiptRequest	The requested receipt was not possible based on recipient settings.
Unreachable	The recipient is not currently reachable.
Spam	The message is considered spam and will not be sent.
Throttled	Carrier volume throttling caused rejection at that point in time.

Note

Receipt statuses can be added to over time. Client integrations should include a catch-all branch for unrecognised statuses.