A message will receive multiple status updates as the message is sent and delivered to end users. However, sometimes delivery, or the delivery report, will fail. Below is a list of all available statuses and a brief explanation of what they mean.
Possible statuses
(0) Waiting
Temporary status received while the message is being processed by Bosbec or the provider. This should eventually be replaced by the status “Sent.”
If it is not replaced after a short period of time, this usually means that we cannot match the following delivery report to this message, and the status can instead be viewed as “Sent.”
(1) Queued
Temporary status received while the message is being processed by Bosbec or the provider. This should eventually be replaced by the status “Sent.”
(2) Error
Something went wrong on the provider’s end, and the message was not delivered.
(3) WaitingForAck
We have sent the message to the provider but are waiting for the provider to acknowledge that the message was received by them.
(4) Sent
Messages receive the status “Sent” as soon as we send them and will keep this status until we receive an update from the provider.
This status does not mean that the message was delivered or not, only that it was sent. Some providers/operators do not provide a status report, and the message will keep this status regardless of the delivery.
(5) Failed
Something went wrong on the provider’s end, and the message was not delivered.
(6) Delivered
The operator has confirmed that the message was delivered to the end user.
(7) Expired
The operator has unsuccessfully tried to deliver the message for a period of time but has eventually stopped trying. This usually happens when a phone is turned off or otherwise unreachable.
(8) None
When no status is available at all. This is very rare.
(9) Deleted
A message will receive the status “Deleted” if it is stuck in a filter or, for some other reason, had to be deleted by the provider/operator.
(10) Undeliverable
The operator confirmed that the messages were not deliverable, usually because they were sent to an incorrect phone number or a subscriber with no network connectivity.
(11) Accepted
Temporary status received while the message is being processed by Bosbec or the provider. This should eventually be replaced by the status “Sent.”
(12) Unknown
Something went wrong on the provider’s end, and the message was most likely not delivered.
(13) Rejected
The message was actively rejected by the provider/operator. For example, the provider/operator has blocked a number series.
(14) Throttled
SMS can sometimes be throttled by the provider when they limit the number of messages being processed. We will try to resend the message, but sometimes the status is not updated.
If it is not replaced after a short period of time, this usually means that we cannot match the following delivery report to this message, and the status can instead be viewed as “Sent.”
(15) Verified
This status is reserved for future use cases and is currently not in use.
(16) Opened
An HTML email will get this status when opened and images are loaded. Note that Gmail will process and load all images before an end user actually opens the email, and they will thus receive the status on delivery.
(17) Read
An SMS or email will get the status “Read” when a short link in the message is opened by the end user.