Delivery Report Availability by Network

Overview

OpenMarket now offers a RESTful and feature-rich Global SMS API. Compared to the existing MX Telecom APIs, the Global SMS API provides:

  • Automated originator selection, which selects the correct short code or VMN for any country or territory
  • Our highest level SLA and increased messaging capacity
  • Better security through Basic authentication
  • A test environment for new and migrating customers

as well as a host of other benefits. While we will continue to support our existing SMS APIs, we believe that our Global SMS API offers some exciting features and benefits that you'll want to take advantage of, and future feature development will be focused on the Global SMS API. For more information, see the Release Note on our Docs and Resources website.

Note that currently the Global SMS API does not support Premium Rate messaging. Existing Premium Rate customers should continue to use the MX Telecom APIs.

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

May be returned for any MT message
Returned only for premium MT messages
 
Symbolic Name Hexadecimal Reason Code
Symbolic name Hexadecimal Reason Code
 
REASON_REJECTED 0x1.0000..
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
 
REASON_REJECTED_BILLING 0x1.0100..
 
$
$
$
$
$
$
$
 
$
$
$
$
 
 
$
 
REASON_REJECTED_BILLING_PSMSBARRED 0x1.0102..
 
 
 
 
$
 
 
 
 
$
 
$
$
 
 
$
 
REASON_REJECTED_BILLING_CHARGEFAILED 0x1.0110..
 
 
 
 
 
 
 
 
 
$
 
 
 
 
 
 
 
REASON_REJECTED_BILLING_OPTINEXPIRED 0x1.0111..
 
 
 
 
 
$
 
 
 
 
 
 
$
 
 
 
 
REASON_REJECTED_BILLING_MANDATE_TERMINATED 0x1.0112..
 
 
 
 
 
 
$
 
 
 
 
 
 
 
 
 
 
REASON_REJECTED_BILLING_MANDATE_EXCEEDED 0x1.0113..
 
 
 
 
 
 
 
 
 
 
 
 
$
 
 
 
 
REASON_REJECTED_BILLING_ACTIVE_OPTIN 0x1.0114..
 
 
 
 
 
$
 
 
 
 
 
 
 
 
 
 
 
REASON_REJECTED_BILLING_SPENDCAP_OR_OUTOFCREDIT 0x1.0120..
 
$
 
 
 
$
$
$
 
$
 
 
$
 
 
 
 
REASON_REJECTED_BILLING_OUTOFCREDIT 0x1.0122..
 
 
 
 
$
 
 
 
 
 
 
 
 
 
 
$
 
REASON_REJECTED_BILLING_ACCOUNT_CLOSED 0x1.0131..
 
$
 
 
$
$
$
$
 
$
 
 
$
 
 
 
 
REASON_REJECTED_BILLING_ACCOUNT_LOCKED 0x1.0132..
 
$
 
 
$
$
$
$
 
$
 
 
$
 
 
 
 
REASON_REJECTED_BILLING_BARRED_RESELLER 0x1.0133..
 
 
 
 
 
$
 
 
 
 
 
 
 
 
 
 
 
REASON_REJECTED_BILLING_BARRED_ADULT 0x1.0134..
 
 
 
 
 
$
 
 
 
 
 
 
 
 
 
 
 
REASON_REJECTED_SOURCE 0x1.0200..
 
 
 
 
 
X
X
X
X
 
 
X
X
X
 
 
 
REASON_REJECTED_SOURCE_NOTPROVISIONED 0x1.0201..
X
$
 
 
$
$
$
$
 
$
 
$
$
X
X
$
 
REASON_REJECTED_SOURCE_NOTPROVISIONEDTESTONLY 0x1.0202..
 
 
 
 
 
 
 
 
 
 
 
X
 
 
 
 
 
REASON_REJECTED_DESTTEMP 0x1.0300..
 
 
 
 
 
X
 
 
 
 
 
 
 
 
 
 
 
REASON_REJECTED_DESTPERM 0x1.0400..
X
 
 
 
 
X
X
 
X
 
 
X
X
X
X
X
 
REASON_REJECTED_DESTPERM_BARRED 0x1.0401..
 
 
 
 
 
 
 
 
 
 
 
X
 
 
 
 
 
REASON_REJECTED_DESTPERM_NOSMS 0x1.0402..
 
 
 
 
 
 
 
 
 
 
 
X
 
 
 
 
 
REASON_REJECTED_DESTPERM_UNKNOWNSUB 0x1.0405..
X
$
 
 
$
$
$
$
 
$
 
$
$
X
X
$
 
REASON_REJECTED_DESTPERM_PORTED 0x1.0406..
 
$
 
 
 
 
 
 
 
$
 
 
 
 
 
 
 
REASON_REJECTED_DESTPERM_RESELLER 0x1.0407..
 
 
 
 
 
 
 
 
 
 
 
X
 
 
 
 
 
REASON_REJECTED_SYSFAIL 0x1.0500..
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
 
REASON_REJECTED_SYSFAIL_BILLING 0x1.0501..
 
$
 
 
$
$
$
$
 
$
 
$
$
 
 
$
 
REASON_REJECTED_MSG_OPTIN 0x1.0603..
 
 
 
 
 
 
 
 
 
 
 
 
$
 
 
 
 
REASON_BUFFERED 0x3.0000..
X
 
 
 
 
 
 
 
 
 
 
 
 
X
X
 
 
REASON_BUFFERED_BILLING_PENDING_OPTIN 0x3.0103..
 
 
 
 
 
$
 
 
 
 
 
 
 
 
 
 
 
REASON_BUFFERED_BILLING_SUCCESSFUL 0x310001..
$
$
 
 
 
$
 
 
 
$
 
$
$
 
 
$
 
REASON_FAILED 0x5.0000..
X
 
 
 
 
X
X
X
X
 
 
 
 
X
X
 
 
REASON_FAILED_EXPIRED 0x5.0004..
 
 
 
 
 
 
X
 
 
 
 
 
 
 
 
 
 
REASON_FAILED_BILLING 0x5.0100..
$
 
 
 
 
 
 
 
 
 
 
 
 
$
$
 
 
REASON_FAILED_BILLING_PSMSBARRED 0x5.0102..
$
 
 
 
 
 
 
 
 
 
 
 
 
$
$
 
 
REASON_FAILED_BILLING_CHARGEFAILED 0x5.0110..
$
 
 
 
 
 
 
 
 
 
 
 
 
$
$
 
 
REASON_FAILED_BILLING_SPENDCAP_OR_OUTOFCREDIT 0x5.0120..
$
 
 
 
 
 
 
 
 
 
 
 
 
$
$
 
 
REASON_FAILED_BILLING_OUTOFCREDIT 0x5.0122..
$
 
 
 
 
 
 
 
 
 
 
 
 
$
$
 
 
REASON_FAILED_BILLING_ACCOUNT_LOCKED 0x5.0132..
$
 
 
 
 
 
 
 
 
 
 
 
 
$
$
 
 
REASON_FAILED_BILLING_BARRED_RESELLER 0x5.0133..
$
 
 
 
 
 
 
 
 
 
 
 
 
$
$
 
 
REASON_FAILED_SOURCE_NOTPROVISIONED 0x5.0201..
X
 
 
 
 
 
 
 
 
 
 
 
 
X
X
 
 
REASON_FAILED_DESTPERM 0x5.0400..
X
 
 
 
 
 
 
 
 
 
 
 
 
X
X
 
 
REASON_FAILED_DESTPERM_BARRED 0x5.0401..
X
 
 
 
 
 
 
 
 
 
 
 
 
X
X
 
 
REASON_FAILED_DESTPERM_NOSMS 0x5.0402..
X
 
 
 
 
 
 
 
 
 
 
 
 
X
X
 
 
REASON_FAILED_DESTPERM_UNKNOWNSUB 0x5.0405..
X
 
 
 
 
 
 
 
 
 
 
 
 
X
X
 
 
REASON_FAILED_SYSFAIL_BILLING 0x5.0501..
$
 
 
 
 
 
 
 
 
 
 
 
 
$
$
 
 
REASON_FAILED_MSG_BINARY 0x5.0602..
X
 
 
 
 
 
 
 
 
 
 
 
 
X
X
 
 
REASON_DELIVERED 0x6.0000..
X
 
 
 
 
X
X
X
X
 
 
 
X
X
X
 
 
REASON_DELIVERED_FAKEMT 0x6.0002..
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
 

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_REJECTED 0x1.0000..
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
 
REASON_REJECTED_BILLING 0x1.0100..
$
$
$
$
$
$
$
$
$
$
$
$
 
$
$
$
$
$
 
REASON_REJECTED_BILLING_CHARGEFAILED 0x1.0110..
$
$
$
$
$
$
$
$
$
$
$
$
 
$
$
$
$
$
 
REASON_REJECTED_SOURCE_NOTPROVISIONED 0x1.0201..
$
$
$
$
$
$
$
$
$
$
$
$
 
$
$
$
$
$
 
REASON_REJECTED_DESTPERM_UNKNOWNSUB 0x1.0405..
$
$
$
$
$
$
$
$
$
$
$
$
 
$
$
$
$
$
 
REASON_REJECTED_SYSFAIL 0x1.0500..
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
 
REASON_REJECTED_SYSFAIL_BILLING 0x1.0501..
$
$
$
$
$
$
$
$
$
$
$
$
 
$
$
$
$
$
 
REASON_FAILED 0x5.0000..
 
 
X
X
 
 
X
 
 
X
X
X
X
X
X
 
X
 
 
REASON_FAILED_EXPIRED 0x5.0004..
 
 
 
X
 
 
 
 
 
 
 
 
X
X
 
 
 
 
 
REASON_DELIVERED 0x6.0000..
X
X
X
X
 
X
 
 
 
X
X
X
X
X
X
 
X
X
 
REASON_DELIVERED_FAKEMT 0x6.0002..
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
 

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_REJECTED 0x1.0000..
X
X
X
X
X
X
X
X
 
REASON_REJECTED_SYSFAIL 0x1.0500..
X
X
X
X
X
X
X
X
 
REASON_FAILED 0x5.0000..
X
X
X
X
X
X
 
X
 
REASON_FAILED_EXPIRED 0x5.0004..
X
X
 
X
 
 
 
 
 
REASON_DELIVERED 0x6.0000..
X
X
X
X
X
 
 
X
 
REASON_DELIVERED_FAKEMT 0x6.0002..
X
X
X
X
X
X
X
X
 

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_REJECTED 0x1.0000..
$
$
$
$
 
REASON_REJECTED_BILLING_OUTOFCREDIT 0x1.0122..
 
$
 
 
 
REASON_REJECTED_BILLING_ACCOUNT_LOCKED 0x1.0132..
 
$
 
 
 
REASON_REJECTED_SOURCE_NOTPROVISIONED 0x1.0201..
 
$
 
 
 
REASON_REJECTED_DESTTEMP_SIMFULL 0x1.0302..
$
 
 
 
 
REASON_REJECTED_DESTPERM 0x1.0400..
$
 
$
$
 
REASON_REJECTED_DESTPERM_BARRED 0x1.0401..
 
$
 
 
 
REASON_REJECTED_SYSFAIL 0x1.0500..
$
 
$
$
 
REASON_FAILED 0x5.0000..
$
 
$
$
 
REASON_FAILED_EXPIRED 0x5.0004..
 
 
 
$
 
REASON_FAILED_BILLING_OUTOFCREDIT 0x5.0122..
$
 
 
$
 
REASON_FAILED_DESTTEMP_BARRED 0x5.0301..
$
 
 
 
 
REASON_FAILED_DESTTEMP_SIMFULL 0x5.0302..
$
 
 
 
 
REASON_FAILED_DESTTEMP_ABSENT 0x5.0303..
$
 
 
 
 
REASON_FAILED_DESTPERM_UNKNOWNSUB 0x5.0405..
$
 
 
 
 
REASON_DELIVERED 0x6.0000..
$
$
$
$
 
REASON_DELIVERED_FAKEMT 0x6.0002..
$
 
$
$
 

Delivery report reason codes available on premium and bulk MT messages to other networks

This information is not currently available. We hope to have it online soon.

For more information, please contact us at 0845 666 7778 or via email at sales@uk.openmarket.com.