Delivery Report Availability by Network
Overview
The delivery report reason codes which may be returned for a given MT message will vary depending on the destination network. The tables below give a summary of which reason codes may be returned.
The Billing nibble and Network byte are independent of the report type and reason bytes, and these are therefore left unspecified in the tables below. They are represented by the character ‘.’.
Contents
- Delivery report reason codes available for MT messages to main US networks
- Delivery report reason codes available for MT messages to TIER3US networks
- Delivery report reason codes available for MT messages to Canadian networks
- Delivery report reason codes available for premium MT messages to Australian networks
- Delivery report reason codes available for premium and bulk MT messages to other networks
Delivery report reason codes available for MT messages to main US networks
![]() |
May be returned for any MT message |
![]() |
Returned only for premium MT messages |
REASON_ REJECTED
An unexpected error occurred during delivery, where we cannot differentiate between a system failure (some part of system not functioning correctly) and an expected failure (unknown subscriber, etc).
REASON_ REJECTED_ EXPIRED
The message exceeded its validity period before a delivery attempt could be made.
REASON_ REJECTED_ BILLING
An unexpected error occurred during billing, where we cannot differentiate between a system failure (some part of system not functioning correctly) and an expected failure (subscriber out of credit, etc).
REASON_ REJECTED_ BILLING_ PREPAYUNSUP
Billing of prepay subscribers is not supported on this network.
REASON_ REJECTED_ BILLING_ PSMSBARRED
Charges to this subscriber have been barred - no further information available from network.
REASON_ REJECTED_ BILLING_ CHARGEFAILED
This charge has been rejected by the network. Used where none of the reasons below apply, but we believe that the subscriber is still billable (unlike REASON_REJECTED_BILLING_PSMSBARRED).
REASON_ REJECTED_ BILLING_ OPTINEXPIRED
On networks where the network controls an opt-in process (eg, AT&T USA OPPC), this reason code is returned if no positive opt-in is received within the timelimit allowed by the network.
REASON_ REJECTED_ BILLING_ MANDATE_ TERMINATED
A previously-active subscription billing mandate has now terminated. No further billing should be performed under this subscription.
REASON_ REJECTED_ BILLING_ MANDATE_ EXCEEDED
This charge exceeds the terms (eg, monthly limit) of a subscription billing mandate.
REASON_ REJECTED_ BILLING_ ACTIVE_ OPTIN
On networks where the network controls an opt-in process (eg, AT&T USA OPPC), this reason code is returned if there is already a pending opt-in process for this subscription.
REASON_ REJECTED_ BILLING_ SPENDCAP_ OR_ OUTOFCREDIT
Subscriber has reached a spending limit, or is out of credit. Used when we cannot distinguish which.
REASON_ REJECTED_ BILLING_ SPENDCAP
Subscriber has reached a spending limit (eg, monthly spend cap).
REASON_ REJECTED_ BILLING_ OUTOFCREDIT
Subscriber has exceeded their credit limit. This is specific to limits which can be resolved by the subscriber adding credit to their account. Note that this may apply to either pre or postpay subscribers.
REASON_ REJECTED_ BILLING_ ACCOUNT_ CLOSED
Attempt to bill against a closed account. This subscriber should not be billed further.
REASON_ REJECTED_ BILLING_ ACCOUNT_ LOCKED
Attempt to bill against a locked/suspended account.
REASON_ REJECTED_ BILLING_ BARRED_ RESELLER
Subscriber obtains connectivity via a reseller; billing of this subscriber is therefore barred.
REASON_ REJECTED_ BILLING_ BARRED_ ADULT
Adult settings on subscriber account prevent billing of subscriber.
REASON_ REJECTED_ SOURCE
Originator on this message was invalid.
REASON_ REJECTED_ SOURCE_ NOTPROVISIONED
Shortcode has not been provisioned. Contact MX Telecom support.
REASON_ REJECTED_ SOURCE_ NOTPROVISIONEDTESTONLY
An attempt was made to send a message to an unwhitelisted subscriber from a shortcode which has only been provisioned for testing.
REASON_ REJECTED_ DESTTEMP
Temporary delivery problem to the destination.
REASON_ REJECTED_ DESTTEMP_ BARRED
Temporary bar on delivery of this content to the destination.
REASON_ REJECTED_ DESTTEMP_ SIMFULL
Message could not be delivered as handset message memory is full.
REASON_ REJECTED_ DESTTEMP_ ABSENT
Message could not be delivered as handset is absent from the network.
REASON_ REJECTED_ DESTTEMP_ DELIVFAIL
Temporary delivery problem to the destination.
REASON_ REJECTED_ DESTPERM
Delivery to this subscriber has failed for an unknown reason. It may be due to a premium-rate bar, so it may still be possible to deliver standard-rate messages to this subscriber after failure of a premium message.
REASON_ REJECTED_ DESTPERM_ BARRED
Delivery to this subscriber has been barred.
REASON_ REJECTED_ DESTPERM_ NOSMS
This subscriber cannot receive bulk or premium SMS messages from any sender
REASON_ REJECTED_ DESTPERM_ UNKNOWNSUB
The destination of this message does not represent a known subscriber. For billing traffic, or traffic within the USA, this may be network specific - i.e. the subscriber may be known by another network. For non-USA bulk messages it means the number is invalid.
REASON_ REJECTED_ DESTPERM_ PORTED
This subscriber is known to have ported off-net; delivery through this network is no longer possible.
REASON_ REJECTED_ DESTPERM_ RESELLER
Subscriber obtains connectivity via a reseller; messaging to this subscriber is therefore barred.
REASON_ REJECTED_ DESTPERM_ MVNO
Subscriber obtains connectivity via a virtual network (MVNO); messaging to this subscriber is therefore barred.
REASON_ REJECTED_ SYSFAIL
Some part of MX Telecom or network systems not functioning correctly. Contact MX Telecom support for more details.
REASON_ REJECTED_ SYSFAIL_ BILLING
As per REASON_REJECTED_SYSFAIL, for errors occuring during billing phase.
REASON_ REJECTED_ MSG
Network rejected message contents. Used where we have no further information as to the problem with the contents.
REASON_ REJECTED_ MSG_ UNICODE
Unicode (UCS2) messages are not supported on this network/shortcode.
REASON_ REJECTED_ MSG_ BINARY
Binary (8-bit) messages are not supported on this network/shortcode.
REASON_ REJECTED_ MSG_ OPTIN
Message could not be submitted to network due to invalid opt-in details
REASON_ BUFFERED
This reason code is returned when we receive a notification from the network that they have been unable to deliver the message, but are continuing to retry.
REASON_ BUFFERED_ BILLING
REASON_ BUFFERED_ BILLING_ PENDING_ OPTIN
The message is being held whilst the network performs an opt-in process (eg, AT&T USA OPPC).
REASON_ BUFFERED_ DESTTEMP_ SIMFULL
Message could not be delivered as handset message memory is full.
REASON_ BUFFERED_ DESTTEMP_ ABSENT
Message could not be delivered as handset is absent from the network.
REASON_ BUFFERED_ DESTTEMP_ DELIVFAIL
Temporary delivery problem to the destination.
REASON_ BUFFERED_ HANDSET_ DELIVERED
Sent when we have received a successful handset delivery report from the network, but billing is still pending.
REASON_ BUFFERED_ HANDSET_ FAILED
Sent when we have received a failed handset delivery report from the network, but billing is still pending. The final delivery report will usually contain more information on why the message failed.
REASON_ BUFFERED_ BILLING_ SUCCESSFUL
Indicates that the message was successfully billed. Note that the Billing nibble will always be set to 1 with this reason code.
REASON_ FAILED
An unexpected error occurred during delivery, where we cannot differentiate between a system failure (some part of system not functioning correctly) and an expected failure (unknown subscriber, etc).
REASON_ FAILED_ EXPIRED
The message exceeded its validity period before a delivery attempt could be made.
REASON_ FAILED_ CREDIT_ CHECK_ SUCCESSFUL
Special reason code for Cricket credit-checking: indicates that the credit check was successful.
REASON_ FAILED_ BILLING
An unexpected error occurred during billing, where we cannot differentiate between a system failure (some part of system not functioning correctly) and an expected failure (subscriber out of credit, etc).
REASON_ FAILED_ BILLING_ PREPAYUNSUP
Billing of prepay subscribers is not supported on this network.
REASON_ FAILED_ BILLING_ PSMSBARRED
Charges to this subscriber have been barred - no further information available from network.
REASON_ FAILED_ BILLING_ CHARGEFAILED
This charge has been rejected by the network. Used where none of the reasons below apply, but we believe that the subscriber is still billable (unlike REASON_REJECTED_BILLING_PSMSBARRED).
REASON_ FAILED_ BILLING_ OPTINEXPIRED
On networks where the network controls an opt-in process (eg, AT&T USA OPPC), this reason code is returned if no positive opt-in is received within the timelimit allowed by the network.
REASON_ FAILED_ BILLING_ MANDATE_ TERMINATED
A previously-active subscription billing mandate has now terminated. No further billing should be performed under this subscription.
REASON_ FAILED_ BILLING_ MANDATE_ EXCEEDED
This charge exceeds the terms (eg, monthly limit) of a subscription billing mandate.
REASON_ FAILED_ BILLING_ ACTIVE_ OPTIN
On networks where the network controls an opt-in process (eg, AT&T USA OPPC), this reason code is returned if there is already a pending opt-in process for this subscription.
REASON_ FAILED_ BILLING_ SPENDCAP_ OR_ OUTOFCREDIT
Subscriber has reached a spending limit, or is out of credit. Used when we cannot distinguish which.
REASON_ FAILED_ BILLING_ SPENDCAP
Subscriber has reached a spending limit (eg, monthly spend cap).
REASON_ FAILED_ BILLING_ OUTOFCREDIT
Subscriber has exceeded their credit limit. This is specific to limits which can be resolved by the subscriber adding credit to their account. Note that this may apply to either pre or postpay subscribers.
REASON_ FAILED_ BILLING_ ACCOUNT_ CLOSED
Attempt to bill against a closed account. This subscriber should not be billed further.
REASON_ FAILED_ BILLING_ ACCOUNT_ LOCKED
Attempt to bill against a locked/suspended account.
REASON_ FAILED_ BILLING_ BARRED_ RESELLER
Subscriber obtains connectivity via a reseller; billing of this subscriber is therefore barred.
REASON_ FAILED_ BILLING_ BARRED_ ADULT
Adult settings on subscriber account prevent billing of subscriber.
REASON_ FAILED_ SOURCE
Originator on this message was invalid.
REASON_ FAILED_ SOURCE_ NOTPROVISIONED
Shortcode has not been provisioned. Contact MX Telecom support.
REASON_ FAILED_ SOURCE_ NOTPROVISIONEDTESTONLY
An attempt was made to send a message to an unwhitelisted subscriber from a shortcode which has only been provisioned for testing.
REASON_ FAILED_ DESTTEMP
Temporary delivery problem to the destination.
REASON_ FAILED_ DESTTEMP_ BARRED
Temporary bar on delivery of this content to the destination.
REASON_ FAILED_ DESTTEMP_ SIMFULL
Message could not be delivered as handset message memory is full.
REASON_ FAILED_ DESTTEMP_ ABSENT
Message could not be delivered as handset is absent from the network.
REASON_ FAILED_ DESTTEMP_ DELIVFAIL
Temporary delivery problem to the destination.
REASON_ FAILED_ DESTPERM
Delivery to this subscriber has failed for an unknown reason. It may be due to a premium-rate bar, so it may still be possible to deliver standard-rate messages to this subscriber after failure of a premium message.
REASON_ FAILED_ DESTPERM_ BARRED
Delivery to this subscriber has been barred.
REASON_ FAILED_ DESTPERM_ NOSMS
This subscriber cannot receive bulk or premium SMS messages from any sender
REASON_ FAILED_ DESTPERM_ UNKNOWNSUB
The destination of this message does not represent a known subscriber. For billing traffic, or traffic within the USA, this may be network specific - i.e. the subscriber may be known by another network. For non-USA bulk messages it means the number is invalid.
REASON_ FAILED_ DESTPERM_ PORTED
This subscriber is known to have ported off-net; delivery through this network is no longer possible.
REASON_ FAILED_ DESTPERM_ RESELLER
Subscriber obtains connectivity via a reseller; messaging to this subscriber is therefore barred.
REASON_ FAILED_ DESTPERM_ MVNO
Subscriber obtains connectivity via a virtual network (MVNO); messaging to this subscriber is therefore barred.
REASON_ FAILED_ SYSFAIL
Some part of MX Telecom or network systems not functioning correctly. Contact MX Telecom support for more details.
REASON_ FAILED_ SYSFAIL_ BILLING
As per REASON_REJECTED_SYSFAIL, for errors occuring during billing phase.
REASON_ FAILED_ MSG
Network rejected message contents. Used where we have no further information as to the problem with the contents.
REASON_ FAILED_ MSG_ UNICODE
Unicode (UCS2) messages are not supported on this network/shortcode.
REASON_ FAILED_ MSG_ BINARY
Binary (8-bit) messages are not supported on this network/shortcode.
REASON_ FAILED_ MSG_ OPTIN
Message could not be submitted to network due to invalid opt-in details
REASON_ DELIVERED
Message delivered to handset.
REASON_ DELIVERED_ FAKEMT
Control message (eg, STOP MT for subscription termination) has been processed.
REASON_ DELIVERED_ NEW_ SUBSCRIPTION
Message delivered to handset. As part of the billing process, a new carrier-managed subscription billing mandate was created with the user's network.
Delivery report reason codes available for MT messages to TIER3US networks
The TIER3US networks are those which can be reached via "ust3" SMS Gateway accounts. The reports supported depend on the network of the destination number.
![]() |
May be returned for any MT message |
![]() |
Returned only for premium MT messages |
|
||||||||||||||||||||
| Symbolic Name | Hexadecimal Reason Code | |||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Symbolic name | Hexadecimal Reason Code |
|
||||||||||||||||||
| REASON_ |
0x1.0000.. | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
|
| REASON_ |
0x1.0100.. | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
||
| REASON_ |
0x1.0110.. | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
||
| REASON_ |
0x1.0201.. | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
||
| REASON_ |
0x1.0405.. | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
||
| REASON_ |
0x1.0500.. | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
|
| REASON_ |
0x1.0501.. | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
||
| REASON_ |
0x5.0000.. | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
|||||||||
| REASON_ |
0x5.0004.. | ![]() |
![]() |
![]() |
||||||||||||||||
| REASON_ |
0x6.0000.. | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
||||||
| REASON_ |
0x6.0002.. | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
|
REASON_ REJECTED
An unexpected error occurred during delivery, where we cannot differentiate between a system failure (some part of system not functioning correctly) and an expected failure (unknown subscriber, etc).
REASON_ REJECTED_ EXPIRED
The message exceeded its validity period before a delivery attempt could be made.
REASON_ REJECTED_ BILLING
An unexpected error occurred during billing, where we cannot differentiate between a system failure (some part of system not functioning correctly) and an expected failure (subscriber out of credit, etc).
REASON_ REJECTED_ BILLING_ PREPAYUNSUP
Billing of prepay subscribers is not supported on this network.
REASON_ REJECTED_ BILLING_ PSMSBARRED
Charges to this subscriber have been barred - no further information available from network.
REASON_ REJECTED_ BILLING_ CHARGEFAILED
This charge has been rejected by the network. Used where none of the reasons below apply, but we believe that the subscriber is still billable (unlike REASON_REJECTED_BILLING_PSMSBARRED).
REASON_ REJECTED_ BILLING_ OPTINEXPIRED
On networks where the network controls an opt-in process (eg, AT&T USA OPPC), this reason code is returned if no positive opt-in is received within the timelimit allowed by the network.
REASON_ REJECTED_ BILLING_ MANDATE_ TERMINATED
A previously-active subscription billing mandate has now terminated. No further billing should be performed under this subscription.
REASON_ REJECTED_ BILLING_ MANDATE_ EXCEEDED
This charge exceeds the terms (eg, monthly limit) of a subscription billing mandate.
REASON_ REJECTED_ BILLING_ ACTIVE_ OPTIN
On networks where the network controls an opt-in process (eg, AT&T USA OPPC), this reason code is returned if there is already a pending opt-in process for this subscription.
REASON_ REJECTED_ BILLING_ SPENDCAP_ OR_ OUTOFCREDIT
Subscriber has reached a spending limit, or is out of credit. Used when we cannot distinguish which.
REASON_ REJECTED_ BILLING_ SPENDCAP
Subscriber has reached a spending limit (eg, monthly spend cap).
REASON_ REJECTED_ BILLING_ OUTOFCREDIT
Subscriber has exceeded their credit limit. This is specific to limits which can be resolved by the subscriber adding credit to their account. Note that this may apply to either pre or postpay subscribers.
REASON_ REJECTED_ BILLING_ ACCOUNT_ CLOSED
Attempt to bill against a closed account. This subscriber should not be billed further.
REASON_ REJECTED_ BILLING_ ACCOUNT_ LOCKED
Attempt to bill against a locked/suspended account.
REASON_ REJECTED_ BILLING_ BARRED_ RESELLER
Subscriber obtains connectivity via a reseller; billing of this subscriber is therefore barred.
REASON_ REJECTED_ BILLING_ BARRED_ ADULT
Adult settings on subscriber account prevent billing of subscriber.
REASON_ REJECTED_ SOURCE
Originator on this message was invalid.
REASON_ REJECTED_ SOURCE_ NOTPROVISIONED
Shortcode has not been provisioned. Contact MX Telecom support.
REASON_ REJECTED_ SOURCE_ NOTPROVISIONEDTESTONLY
An attempt was made to send a message to an unwhitelisted subscriber from a shortcode which has only been provisioned for testing.
REASON_ REJECTED_ DESTTEMP
Temporary delivery problem to the destination.
REASON_ REJECTED_ DESTTEMP_ BARRED
Temporary bar on delivery of this content to the destination.
REASON_ REJECTED_ DESTTEMP_ SIMFULL
Message could not be delivered as handset message memory is full.
REASON_ REJECTED_ DESTTEMP_ ABSENT
Message could not be delivered as handset is absent from the network.
REASON_ REJECTED_ DESTTEMP_ DELIVFAIL
Temporary delivery problem to the destination.
REASON_ REJECTED_ DESTPERM
Delivery to this subscriber has failed for an unknown reason. It may be due to a premium-rate bar, so it may still be possible to deliver standard-rate messages to this subscriber after failure of a premium message.
REASON_ REJECTED_ DESTPERM_ BARRED
Delivery to this subscriber has been barred.
REASON_ REJECTED_ DESTPERM_ NOSMS
This subscriber cannot receive bulk or premium SMS messages from any sender
REASON_ REJECTED_ DESTPERM_ UNKNOWNSUB
The destination of this message does not represent a known subscriber. For billing traffic, or traffic within the USA, this may be network specific - i.e. the subscriber may be known by another network. For non-USA bulk messages it means the number is invalid.
REASON_ REJECTED_ DESTPERM_ PORTED
This subscriber is known to have ported off-net; delivery through this network is no longer possible.
REASON_ REJECTED_ DESTPERM_ RESELLER
Subscriber obtains connectivity via a reseller; messaging to this subscriber is therefore barred.
REASON_ REJECTED_ DESTPERM_ MVNO
Subscriber obtains connectivity via a virtual network (MVNO); messaging to this subscriber is therefore barred.
REASON_ REJECTED_ SYSFAIL
Some part of MX Telecom or network systems not functioning correctly. Contact MX Telecom support for more details.
REASON_ REJECTED_ SYSFAIL_ BILLING
As per REASON_REJECTED_SYSFAIL, for errors occuring during billing phase.
REASON_ REJECTED_ MSG
Network rejected message contents. Used where we have no further information as to the problem with the contents.
REASON_ REJECTED_ MSG_ UNICODE
Unicode (UCS2) messages are not supported on this network/shortcode.
REASON_ REJECTED_ MSG_ BINARY
Binary (8-bit) messages are not supported on this network/shortcode.
REASON_ REJECTED_ MSG_ OPTIN
Message could not be submitted to network due to invalid opt-in details
REASON_ BUFFERED
This reason code is returned when we receive a notification from the network that they have been unable to deliver the message, but are continuing to retry.
REASON_ BUFFERED_ BILLING
REASON_ BUFFERED_ BILLING_ PENDING_ OPTIN
The message is being held whilst the network performs an opt-in process (eg, AT&T USA OPPC).
REASON_ BUFFERED_ DESTTEMP_ SIMFULL
Message could not be delivered as handset message memory is full.
REASON_ BUFFERED_ DESTTEMP_ ABSENT
Message could not be delivered as handset is absent from the network.
REASON_ BUFFERED_ DESTTEMP_ DELIVFAIL
Temporary delivery problem to the destination.
REASON_ BUFFERED_ HANDSET_ DELIVERED
Sent when we have received a successful handset delivery report from the network, but billing is still pending.
REASON_ BUFFERED_ HANDSET_ FAILED
Sent when we have received a failed handset delivery report from the network, but billing is still pending. The final delivery report will usually contain more information on why the message failed.
REASON_ BUFFERED_ BILLING_ SUCCESSFUL
Indicates that the message was successfully billed. Note that the Billing nibble will always be set to 1 with this reason code.
REASON_ FAILED
An unexpected error occurred during delivery, where we cannot differentiate between a system failure (some part of system not functioning correctly) and an expected failure (unknown subscriber, etc).
REASON_ FAILED_ EXPIRED
The message exceeded its validity period before a delivery attempt could be made.
REASON_ FAILED_ CREDIT_ CHECK_ SUCCESSFUL
Special reason code for Cricket credit-checking: indicates that the credit check was successful.
REASON_ FAILED_ BILLING
An unexpected error occurred during billing, where we cannot differentiate between a system failure (some part of system not functioning correctly) and an expected failure (subscriber out of credit, etc).
REASON_ FAILED_ BILLING_ PREPAYUNSUP
Billing of prepay subscribers is not supported on this network.
REASON_ FAILED_ BILLING_ PSMSBARRED
Charges to this subscriber have been barred - no further information available from network.
REASON_ FAILED_ BILLING_ CHARGEFAILED
This charge has been rejected by the network. Used where none of the reasons below apply, but we believe that the subscriber is still billable (unlike REASON_REJECTED_BILLING_PSMSBARRED).
REASON_ FAILED_ BILLING_ OPTINEXPIRED
On networks where the network controls an opt-in process (eg, AT&T USA OPPC), this reason code is returned if no positive opt-in is received within the timelimit allowed by the network.
REASON_ FAILED_ BILLING_ MANDATE_ TERMINATED
A previously-active subscription billing mandate has now terminated. No further billing should be performed under this subscription.
REASON_ FAILED_ BILLING_ MANDATE_ EXCEEDED
This charge exceeds the terms (eg, monthly limit) of a subscription billing mandate.
REASON_ FAILED_ BILLING_ ACTIVE_ OPTIN
On networks where the network controls an opt-in process (eg, AT&T USA OPPC), this reason code is returned if there is already a pending opt-in process for this subscription.
REASON_ FAILED_ BILLING_ SPENDCAP_ OR_ OUTOFCREDIT
Subscriber has reached a spending limit, or is out of credit. Used when we cannot distinguish which.
REASON_ FAILED_ BILLING_ SPENDCAP
Subscriber has reached a spending limit (eg, monthly spend cap).
REASON_ FAILED_ BILLING_ OUTOFCREDIT
Subscriber has exceeded their credit limit. This is specific to limits which can be resolved by the subscriber adding credit to their account. Note that this may apply to either pre or postpay subscribers.
REASON_ FAILED_ BILLING_ ACCOUNT_ CLOSED
Attempt to bill against a closed account. This subscriber should not be billed further.
REASON_ FAILED_ BILLING_ ACCOUNT_ LOCKED
Attempt to bill against a locked/suspended account.
REASON_ FAILED_ BILLING_ BARRED_ RESELLER
Subscriber obtains connectivity via a reseller; billing of this subscriber is therefore barred.
REASON_ FAILED_ BILLING_ BARRED_ ADULT
Adult settings on subscriber account prevent billing of subscriber.
REASON_ FAILED_ SOURCE
Originator on this message was invalid.
REASON_ FAILED_ SOURCE_ NOTPROVISIONED
Shortcode has not been provisioned. Contact MX Telecom support.
REASON_ FAILED_ SOURCE_ NOTPROVISIONEDTESTONLY
An attempt was made to send a message to an unwhitelisted subscriber from a shortcode which has only been provisioned for testing.
REASON_ FAILED_ DESTTEMP
Temporary delivery problem to the destination.
REASON_ FAILED_ DESTTEMP_ BARRED
Temporary bar on delivery of this content to the destination.
REASON_ FAILED_ DESTTEMP_ SIMFULL
Message could not be delivered as handset message memory is full.
REASON_ FAILED_ DESTTEMP_ ABSENT
Message could not be delivered as handset is absent from the network.
REASON_ FAILED_ DESTTEMP_ DELIVFAIL
Temporary delivery problem to the destination.
REASON_ FAILED_ DESTPERM
Delivery to this subscriber has failed for an unknown reason. It may be due to a premium-rate bar, so it may still be possible to deliver standard-rate messages to this subscriber after failure of a premium message.
REASON_ FAILED_ DESTPERM_ BARRED
Delivery to this subscriber has been barred.
REASON_ FAILED_ DESTPERM_ NOSMS
This subscriber cannot receive bulk or premium SMS messages from any sender
REASON_ FAILED_ DESTPERM_ UNKNOWNSUB
The destination of this message does not represent a known subscriber. For billing traffic, or traffic within the USA, this may be network specific - i.e. the subscriber may be known by another network. For non-USA bulk messages it means the number is invalid.
REASON_ FAILED_ DESTPERM_ PORTED
This subscriber is known to have ported off-net; delivery through this network is no longer possible.
REASON_ FAILED_ DESTPERM_ RESELLER
Subscriber obtains connectivity via a reseller; messaging to this subscriber is therefore barred.
REASON_ FAILED_ DESTPERM_ MVNO
Subscriber obtains connectivity via a virtual network (MVNO); messaging to this subscriber is therefore barred.
REASON_ FAILED_ SYSFAIL
Some part of MX Telecom or network systems not functioning correctly. Contact MX Telecom support for more details.
REASON_ FAILED_ SYSFAIL_ BILLING
As per REASON_REJECTED_SYSFAIL, for errors occuring during billing phase.
REASON_ FAILED_ MSG
Network rejected message contents. Used where we have no further information as to the problem with the contents.
REASON_ FAILED_ MSG_ UNICODE
Unicode (UCS2) messages are not supported on this network/shortcode.
REASON_ FAILED_ MSG_ BINARY
Binary (8-bit) messages are not supported on this network/shortcode.
REASON_ FAILED_ MSG_ OPTIN
Message could not be submitted to network due to invalid opt-in details
REASON_ DELIVERED
Message delivered to handset.
REASON_ DELIVERED_ FAKEMT
Control message (eg, STOP MT for subscription termination) has been processed.
REASON_ DELIVERED_ NEW_ SUBSCRIPTION
Message delivered to handset. As part of the billing process, a new carrier-managed subscription billing mandate was created with the user's network.
Delivery report reason codes available for MT messages to Canadian networks
![]() |
May be returned for any MT message |
|
||||||||||
| Symbolic Name | Hexadecimal Reason Code | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Symbolic name | Hexadecimal Reason Code |
|
||||||||
| REASON_ |
0x1.0000.. | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
|
| REASON_ |
0x1.0500.. | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
|
| REASON_ |
0x5.0000.. | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
||
| REASON_ |
0x5.0004.. | ![]() |
![]() |
![]() |
||||||
| REASON_ |
0x6.0000.. | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
|||
| REASON_ |
0x6.0002.. | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
|
REASON_ REJECTED
An unexpected error occurred during delivery, where we cannot differentiate between a system failure (some part of system not functioning correctly) and an expected failure (unknown subscriber, etc).
REASON_ REJECTED_ EXPIRED
The message exceeded its validity period before a delivery attempt could be made.
REASON_ REJECTED_ BILLING
An unexpected error occurred during billing, where we cannot differentiate between a system failure (some part of system not functioning correctly) and an expected failure (subscriber out of credit, etc).
REASON_ REJECTED_ BILLING_ PREPAYUNSUP
Billing of prepay subscribers is not supported on this network.
REASON_ REJECTED_ BILLING_ PSMSBARRED
Charges to this subscriber have been barred - no further information available from network.
REASON_ REJECTED_ BILLING_ CHARGEFAILED
This charge has been rejected by the network. Used where none of the reasons below apply, but we believe that the subscriber is still billable (unlike REASON_REJECTED_BILLING_PSMSBARRED).
REASON_ REJECTED_ BILLING_ OPTINEXPIRED
On networks where the network controls an opt-in process (eg, AT&T USA OPPC), this reason code is returned if no positive opt-in is received within the timelimit allowed by the network.
REASON_ REJECTED_ BILLING_ MANDATE_ TERMINATED
A previously-active subscription billing mandate has now terminated. No further billing should be performed under this subscription.
REASON_ REJECTED_ BILLING_ MANDATE_ EXCEEDED
This charge exceeds the terms (eg, monthly limit) of a subscription billing mandate.
REASON_ REJECTED_ BILLING_ ACTIVE_ OPTIN
On networks where the network controls an opt-in process (eg, AT&T USA OPPC), this reason code is returned if there is already a pending opt-in process for this subscription.
REASON_ REJECTED_ BILLING_ SPENDCAP_ OR_ OUTOFCREDIT
Subscriber has reached a spending limit, or is out of credit. Used when we cannot distinguish which.
REASON_ REJECTED_ BILLING_ SPENDCAP
Subscriber has reached a spending limit (eg, monthly spend cap).
REASON_ REJECTED_ BILLING_ OUTOFCREDIT
Subscriber has exceeded their credit limit. This is specific to limits which can be resolved by the subscriber adding credit to their account. Note that this may apply to either pre or postpay subscribers.
REASON_ REJECTED_ BILLING_ ACCOUNT_ CLOSED
Attempt to bill against a closed account. This subscriber should not be billed further.
REASON_ REJECTED_ BILLING_ ACCOUNT_ LOCKED
Attempt to bill against a locked/suspended account.
REASON_ REJECTED_ BILLING_ BARRED_ RESELLER
Subscriber obtains connectivity via a reseller; billing of this subscriber is therefore barred.
REASON_ REJECTED_ BILLING_ BARRED_ ADULT
Adult settings on subscriber account prevent billing of subscriber.
REASON_ REJECTED_ SOURCE
Originator on this message was invalid.
REASON_ REJECTED_ SOURCE_ NOTPROVISIONED
Shortcode has not been provisioned. Contact MX Telecom support.
REASON_ REJECTED_ SOURCE_ NOTPROVISIONEDTESTONLY
An attempt was made to send a message to an unwhitelisted subscriber from a shortcode which has only been provisioned for testing.
REASON_ REJECTED_ DESTTEMP
Temporary delivery problem to the destination.
REASON_ REJECTED_ DESTTEMP_ BARRED
Temporary bar on delivery of this content to the destination.
REASON_ REJECTED_ DESTTEMP_ SIMFULL
Message could not be delivered as handset message memory is full.
REASON_ REJECTED_ DESTTEMP_ ABSENT
Message could not be delivered as handset is absent from the network.
REASON_ REJECTED_ DESTTEMP_ DELIVFAIL
Temporary delivery problem to the destination.
REASON_ REJECTED_ DESTPERM
Delivery to this subscriber has failed for an unknown reason. It may be due to a premium-rate bar, so it may still be possible to deliver standard-rate messages to this subscriber after failure of a premium message.
REASON_ REJECTED_ DESTPERM_ BARRED
Delivery to this subscriber has been barred.
REASON_ REJECTED_ DESTPERM_ NOSMS
This subscriber cannot receive bulk or premium SMS messages from any sender
REASON_ REJECTED_ DESTPERM_ UNKNOWNSUB
The destination of this message does not represent a known subscriber. For billing traffic, or traffic within the USA, this may be network specific - i.e. the subscriber may be known by another network. For non-USA bulk messages it means the number is invalid.
REASON_ REJECTED_ DESTPERM_ PORTED
This subscriber is known to have ported off-net; delivery through this network is no longer possible.
REASON_ REJECTED_ DESTPERM_ RESELLER
Subscriber obtains connectivity via a reseller; messaging to this subscriber is therefore barred.
REASON_ REJECTED_ DESTPERM_ MVNO
Subscriber obtains connectivity via a virtual network (MVNO); messaging to this subscriber is therefore barred.
REASON_ REJECTED_ SYSFAIL
Some part of MX Telecom or network systems not functioning correctly. Contact MX Telecom support for more details.
REASON_ REJECTED_ SYSFAIL_ BILLING
As per REASON_REJECTED_SYSFAIL, for errors occuring during billing phase.
REASON_ REJECTED_ MSG
Network rejected message contents. Used where we have no further information as to the problem with the contents.
REASON_ REJECTED_ MSG_ UNICODE
Unicode (UCS2) messages are not supported on this network/shortcode.
REASON_ REJECTED_ MSG_ BINARY
Binary (8-bit) messages are not supported on this network/shortcode.
REASON_ REJECTED_ MSG_ OPTIN
Message could not be submitted to network due to invalid opt-in details
REASON_ BUFFERED
This reason code is returned when we receive a notification from the network that they have been unable to deliver the message, but are continuing to retry.
REASON_ BUFFERED_ BILLING
REASON_ BUFFERED_ BILLING_ PENDING_ OPTIN
The message is being held whilst the network performs an opt-in process (eg, AT&T USA OPPC).
REASON_ BUFFERED_ DESTTEMP_ SIMFULL
Message could not be delivered as handset message memory is full.
REASON_ BUFFERED_ DESTTEMP_ ABSENT
Message could not be delivered as handset is absent from the network.
REASON_ BUFFERED_ DESTTEMP_ DELIVFAIL
Temporary delivery problem to the destination.
REASON_ BUFFERED_ HANDSET_ DELIVERED
Sent when we have received a successful handset delivery report from the network, but billing is still pending.
REASON_ BUFFERED_ HANDSET_ FAILED
Sent when we have received a failed handset delivery report from the network, but billing is still pending. The final delivery report will usually contain more information on why the message failed.
REASON_ BUFFERED_ BILLING_ SUCCESSFUL
Indicates that the message was successfully billed. Note that the Billing nibble will always be set to 1 with this reason code.
REASON_ FAILED
An unexpected error occurred during delivery, where we cannot differentiate between a system failure (some part of system not functioning correctly) and an expected failure (unknown subscriber, etc).
REASON_ FAILED_ EXPIRED
The message exceeded its validity period before a delivery attempt could be made.
REASON_ FAILED_ CREDIT_ CHECK_ SUCCESSFUL
Special reason code for Cricket credit-checking: indicates that the credit check was successful.
REASON_ FAILED_ BILLING
An unexpected error occurred during billing, where we cannot differentiate between a system failure (some part of system not functioning correctly) and an expected failure (subscriber out of credit, etc).
REASON_ FAILED_ BILLING_ PREPAYUNSUP
Billing of prepay subscribers is not supported on this network.
REASON_ FAILED_ BILLING_ PSMSBARRED
Charges to this subscriber have been barred - no further information available from network.
REASON_ FAILED_ BILLING_ CHARGEFAILED
This charge has been rejected by the network. Used where none of the reasons below apply, but we believe that the subscriber is still billable (unlike REASON_REJECTED_BILLING_PSMSBARRED).
REASON_ FAILED_ BILLING_ OPTINEXPIRED
On networks where the network controls an opt-in process (eg, AT&T USA OPPC), this reason code is returned if no positive opt-in is received within the timelimit allowed by the network.
REASON_ FAILED_ BILLING_ MANDATE_ TERMINATED
A previously-active subscription billing mandate has now terminated. No further billing should be performed under this subscription.
REASON_ FAILED_ BILLING_ MANDATE_ EXCEEDED
This charge exceeds the terms (eg, monthly limit) of a subscription billing mandate.
REASON_ FAILED_ BILLING_ ACTIVE_ OPTIN
On networks where the network controls an opt-in process (eg, AT&T USA OPPC), this reason code is returned if there is already a pending opt-in process for this subscription.
REASON_ FAILED_ BILLING_ SPENDCAP_ OR_ OUTOFCREDIT
Subscriber has reached a spending limit, or is out of credit. Used when we cannot distinguish which.
REASON_ FAILED_ BILLING_ SPENDCAP
Subscriber has reached a spending limit (eg, monthly spend cap).
REASON_ FAILED_ BILLING_ OUTOFCREDIT
Subscriber has exceeded their credit limit. This is specific to limits which can be resolved by the subscriber adding credit to their account. Note that this may apply to either pre or postpay subscribers.
REASON_ FAILED_ BILLING_ ACCOUNT_ CLOSED
Attempt to bill against a closed account. This subscriber should not be billed further.
REASON_ FAILED_ BILLING_ ACCOUNT_ LOCKED
Attempt to bill against a locked/suspended account.
REASON_ FAILED_ BILLING_ BARRED_ RESELLER
Subscriber obtains connectivity via a reseller; billing of this subscriber is therefore barred.
REASON_ FAILED_ BILLING_ BARRED_ ADULT
Adult settings on subscriber account prevent billing of subscriber.
REASON_ FAILED_ SOURCE
Originator on this message was invalid.
REASON_ FAILED_ SOURCE_ NOTPROVISIONED
Shortcode has not been provisioned. Contact MX Telecom support.
REASON_ FAILED_ SOURCE_ NOTPROVISIONEDTESTONLY
An attempt was made to send a message to an unwhitelisted subscriber from a shortcode which has only been provisioned for testing.
REASON_ FAILED_ DESTTEMP
Temporary delivery problem to the destination.
REASON_ FAILED_ DESTTEMP_ BARRED
Temporary bar on delivery of this content to the destination.
REASON_ FAILED_ DESTTEMP_ SIMFULL
Message could not be delivered as handset message memory is full.
REASON_ FAILED_ DESTTEMP_ ABSENT
Message could not be delivered as handset is absent from the network.
REASON_ FAILED_ DESTTEMP_ DELIVFAIL
Temporary delivery problem to the destination.
REASON_ FAILED_ DESTPERM
Delivery to this subscriber has failed for an unknown reason. It may be due to a premium-rate bar, so it may still be possible to deliver standard-rate messages to this subscriber after failure of a premium message.
REASON_ FAILED_ DESTPERM_ BARRED
Delivery to this subscriber has been barred.
REASON_ FAILED_ DESTPERM_ NOSMS
This subscriber cannot receive bulk or premium SMS messages from any sender
REASON_ FAILED_ DESTPERM_ UNKNOWNSUB
The destination of this message does not represent a known subscriber. For billing traffic, or traffic within the USA, this may be network specific - i.e. the subscriber may be known by another network. For non-USA bulk messages it means the number is invalid.
REASON_ FAILED_ DESTPERM_ PORTED
This subscriber is known to have ported off-net; delivery through this network is no longer possible.
REASON_ FAILED_ DESTPERM_ RESELLER
Subscriber obtains connectivity via a reseller; messaging to this subscriber is therefore barred.
REASON_ FAILED_ DESTPERM_ MVNO
Subscriber obtains connectivity via a virtual network (MVNO); messaging to this subscriber is therefore barred.
REASON_ FAILED_ SYSFAIL
Some part of MX Telecom or network systems not functioning correctly. Contact MX Telecom support for more details.
REASON_ FAILED_ SYSFAIL_ BILLING
As per REASON_REJECTED_SYSFAIL, for errors occuring during billing phase.
REASON_ FAILED_ MSG
Network rejected message contents. Used where we have no further information as to the problem with the contents.
REASON_ FAILED_ MSG_ UNICODE
Unicode (UCS2) messages are not supported on this network/shortcode.
REASON_ FAILED_ MSG_ BINARY
Binary (8-bit) messages are not supported on this network/shortcode.
REASON_ FAILED_ MSG_ OPTIN
Message could not be submitted to network due to invalid opt-in details
REASON_ DELIVERED
Message delivered to handset.
REASON_ DELIVERED_ FAKEMT
Control message (eg, STOP MT for subscription termination) has been processed.
REASON_ DELIVERED_ NEW_ SUBSCRIPTION
Message delivered to handset. As part of the billing process, a new carrier-managed subscription billing mandate was created with the user's network.
Delivery report reason codes available for premium MT messages to Australian networks
![]() |
May be returned for any premium MT message |
|
||||||
| Symbolic Name | Hexadecimal Reason Code | |||||
|---|---|---|---|---|---|---|
| Symbolic name | Hexadecimal Reason Code |
|
||||
| REASON_ |
0x1.0000.. | ![]() |
![]() |
![]() |
![]() |
|
| REASON_ |
0x1.0122.. | ![]() |
||||
| REASON_ |
0x1.0132.. | ![]() |
||||
| REASON_ |
0x1.0201.. | ![]() |
||||
| REASON_ |
0x1.0302.. | ![]() |
||||
| REASON_ |
0x1.0400.. | ![]() |
![]() |
![]() |
||
| REASON_ |
0x1.0401.. | ![]() |
||||
| REASON_ |
0x1.0500.. | ![]() |
![]() |
![]() |
||
| REASON_ |
0x5.0000.. | ![]() |
![]() |
![]() |
||
| REASON_ |
0x5.0004.. | ![]() |
||||
| REASON_ |
0x5.0122.. | ![]() |
![]() |
|||
| REASON_ |
0x5.0301.. | ![]() |
||||
| REASON_ |
0x5.0302.. | ![]() |
||||
| REASON_ |
0x5.0303.. | ![]() |
||||
| REASON_ |
0x5.0405.. | ![]() |
||||
| REASON_ |
0x6.0000.. | ![]() |
![]() |
![]() |
![]() |
|
| REASON_ |
0x6.0002.. | ![]() |
![]() |
![]() |
||



