When we receive a delivery receipt for an SMS message from a carrier, we turn that receipt into a simple status so you can see whether your message arrived and, if it didn't, why.
A message that isn't delivered is called a bounce, and every bounce is either hard or soft.
Hard bounces
A hard bounce normally indicates a permanent issue with message delivery to a particular recipient. Re-sending the same message to a hard bounced number is very unlikely to result in a successful delivery.
Types of hard bounce
Rejected
The recipient's mobile carrier received the message but declined to pass it on. Carriers can decline messages for a number of reasons, so the message won't be delivered as sent.
Refused
The message was refused and won't be delivered.
Common reasons for Rejected or Refused bounces
The end user has opted out of receiving messages.
The message was sent to a number that isn’t enabled for SMS.
There is an issue with the provider’s network.
The end user’s handset is roaming.
The number sent to is incorrect.
InvalidNumber
The message couldn't reach the recipient. This typically means the number isn't in service, has been disconnected, or can't receive text messages.
What you can do
Check that the number you’re trying to send to is correct and still active.
If multiple messages are rejected or refused, contact us and we can review the detailed carrier response with you.
Soft bounces
A soft bounce is usually a temporary issue with sending to a particular recipient. It’s quite possible that a later send to the same recipient is successful.
Types of soft bounce
Expired
Delivery is attempted during a set window called the validity period. The message couldn't be delivered before it closed, for example because the phone was off or out of coverage the whole time.
FullSIM
The recipient's phone had no room left to receive new messages.
RejectedSMSC
The carrier's message centre, the system that delivers texts to phones on its network, wasn't able to send the message.
NoCredit
The recipient's mobile account didn't have enough credit, which can happen with pay-as-you-go plans.
NoResponse
The carrier never confirmed whether the message was delivered.
Carriers normally send a delivery receipt saying whether a message arrived. If that receipt never comes, we mark the message NoResponse once:
The message was handed to the carrier and awaiting confirmation.
andEight days have passed since it was handed to the carrier.
andIt’s at least one day past the message’s validity period.
Types of delivery receipt
Toll-free and short code
Return handset delivery receipts.
10DLC
Returns network delivery receipts.
