Message Statuses

Message Statuses are provided at different times in a messages journey to the destination:

1. The initial send to carrier provides a basic status.

2. Whilst the message is in transit through the carrier networks.

3. When the message arrives at the destination.

At any point in the journey a receipt with a status can be received. It is possible to receive multiple receipts for the same message whilst it is on its journey.

The following is a list of the possible statuses:

Status	Description
Received	Received by DIY Surveys to process. This will mean that it has not yet been processed either because DIY Surveys is waiting for the carrier to respond or the Windows and When parameters provided 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 black listed by the carrier. The distinction between this and block is not always made clear between carriers.
Failure	There was a problem submitting to the carrier. This covers all other potential issues with the carrier.
LandlineUnknown	This number is associated with a landline or is unknown and therefore should not be used. It is possible to check the destination before the message is sent and this status indicated that the message was destined for a landline and therefore was not sent.
NoRoute	DIY Surveys is unable to find a suitable route for this message to be sent. In this case you should contact DIY Surveys Support.
Killed	The number was killed from further activity if it was queued up for sending out a message.
Notkilled	The number was not killed because the message may have already been sent.
Queued	The message has been queued to be sent and awaiting confirmation of a submitted or failure type status.
Submitted	The message has been submitted to the network for delivery with the potential to get a receipt confirm success or failure.
InvalidSourceNumber	The number specified as the source is unsuitable for sending this message. In most cases this can be caused by the route the message is taking not supporting branded source numbers (e.g. DIY). In other cases, it can be a network specific issue.
InvalidDestinationNumber	The destinat4ion number does not match a recognised destination. Destination number, must include a country code followed by the require number of digits for the country (e.g. For the UK, the country code is 44, followed by the number 9999999999 resulting in 449999999999).
BufferedForRetry	Due to the load on the messaging networks the message is being buffered (or paused) whilst another attempt is carried out. The number of times this happens is at the discretion of the carrier and is usual dependent on the quality of the route.
Busy	The destination device is unable to accept the message because it is busy. This is a device specific issue.
InternalFailure	DIY Surveys was unable to process this message due to an internal failure. In this case you should contact DIY Surveys Support.
Unknown	DIY Surveys was unable to establish the status of the message from a badly formed receipt. In some instances, this is because the network itself could not establish the reason. In these cases, DIY Surveys may investigate to assess whether with the carrier what corrections can be made.
Unrouteable	A message can be unrouteable if the destination number was incorrect, or the carrier were unable to route the message to the destination. In these cases, it is up to you to make the necessary adjustments and/or choose whether you want to resubmit the message again. Persistent failures indicate the number is not available to send messages to.
Undelivered	The message was undelivered. This covers multiple issues across the SMS networks, where a message cannot be carried onto its final destination and a specific issue (as listed above) cannot be assigned. Further investigation is not available.
Expired	The message took too long to process by the carriers and therefore expired. This is an arbitrary time, but it is usually around 3 days before a message expires and will not be sent. This is not controlled by DIY Surveys.

Note: These receipt statuses can be added to for greater refinement. It is incumbent on the developer to ensure there is some "Catch All" feature in their code for receipts that are not recognised.

For more information about sending messages check here.