Delivery receipt status codes and message states

The following describe the status codes and messages states for delivery receipts. Status codes are returned in the receipt short message error name:value pair. Status codes and descriptions are returned in the following OpenMarket-specific TLVs When a delivery receipt is received, the TLV message state will return one of the following status codes and associated description:

  • ENROUTE
  • DELIVRD
  • EXPIRED
  • DELETED
  • UNDELIV
  • ACCEPTD
  • UNKNOWN
  • REJECTD

Search this page for a specific code or description:

OpenMarket Status Code

Message

Description

0

Message sent

OpenMarket successfully sent the message to the carrier's network. In some situations the mobile operator will not return any further update than this receipt—for example, for a message sent using a US landline. For a final delivery receipt, this is considered a successful delivery.

Than

Short Message State: DELIVRD

Retryable: N/A

4

Message delivered

The carrier successfully delivered the message to the end user.


Short Message State: DELIVRD

Retryable: N/A

341

Value of mobileOperator does not exist

A mobile operator ID was submitted which is not in the list of OpenMarket-supported mobile operators


Short Message State: REJECTD

Retryable: No

345

Mobile operator not found for the destination address

The service performed a dynamic carrier lookup for the destination address, but it could not be identified; or, the MT source address is not a North American toll-free phone number or landline.


Short Message State: UNDELIV

Retryable: No

351

Invalid destination address

Mobile operators send a delivery receipt for a variety of reasons. Unfortunately, error conditions are mixed between messages you can retry sending or not, based on the operator's own use of this code. If you are messaging anywhere outside of the US, we cannot refine the issue further, other than knowing that the message was sent using the right encoding to the correct mobile operator.

However, possible reasons for the following mobile operators might be:

  • Any operator: The mobile number is not on the mobile operator's network.
  • Any operator: The mobile number has been deactivated. Check the number against the list of deactivated numbers in the Deactivated Phone Numbers Report in Customer Center.
  • T-Mobile and MetroPCS: The phone number belongs to a prepaid user who does not have enough credit to receive an SMS.
  • T-Mobile only: The end user is not provisioned to receive SMS from all short codes (or from specific short codes).
  • T-Mobile only: The end user is on a MVNO connected via T-Mobile. T-Mobile does not deliver SMS messages from short codes to end users on MVNOs.
  • AT&T US: There are several possible causes for the error:
    • The phone number belongs to a prepaid user who does not have enough credit to receive an SMS.
    • The phone number is not provisioned for SMS.
    • The phone number could be blocked due to a spam complaint.

In general, mobile operators do not want SMS senders to retry MT messages that have failed with error code 351. However, given the range of different possible root causes, it is reasonable to retry some of these messages. Suggested options are:

  • Perform a number preview request to confirm that the number is on the mobile operator's network.
  • Check the number against the list of deactivated numbers in the Deactivated Phone Numbers Report in Customer Center.
  • For T-Mobile specifically, you could retry the message using a US VMN or other number.
  • If needed, retry the message using a slow retry method—for example, retrying once every day for up to seven days.

Short Message State: Mobile Operator

Retryable: Conditional

355

Message text is too long

OpenMarket did not forward the message to the mobile operator.


Short Message State: Mobile operator-dependent

Retryable: No

368 Invalid source address

The mobile operator rejected the message with an invalid MT source address error. Contact your account manager to determine if your MT source address should be supported by the end user's mobile operator.



Short Message State: REJECTD

Retryable: No

375

Source address is blocked or is not provisioned

Possible causes might be:

  • Your message originator is currently blocked from sending messages.
  • You tried to use a TON 1 or TON 3 MT source address that is not provisioned on your account.
  • There is a mismatch between the MT source address TON and the MT address. Verify that you are sending MTs from short codes with TON set to 3 and sending MTs from VMNs with TON set to 1.

Talk to your OpenMarket account manager if you are unsure why you received this error.


Short Message State: Mobile operator-dependent

Retryable: No

433 Account access denied

Your application account is not provisioned to send messages to the mobile network operator. Contact your OpenMarket account manager to change the provisioning of your account.

Retryable: No

541 The mobile operator accepted the message but delivery failed because the TPS was exceeded

The message was blocked by AT&T because the TPS (transactions per second) limit on your messaging campaign has been exceeded.

Retryable: Yes you can try re-sending the message, though delivery cannot be guaranteed. You may still encounter the TPS limit.

542 The mobile operator accepted the message but delivery failed because the daily bucket size has been exceeded

The message was blocked by T-Mobile because the daily volume limit for your brand has been exceeded. You cannot resend the message until the next day.

Retryable: no

560

Mobile operator blocking the end user from this short code

Mobile operator-dependent

Retryable: No

561

Content blocked by mobile operator for this end user

The message was blocked by AT&T's spam filter.

Retryable: No

562

Short code not provisioned with mobile operator

Contact your OpenMarket account manager if you believe that you are provisioned for the operator or if you want to begin provisioning.


Short Message State: Mobile operator-dependent

Retryable: No

563

Short code expired with mobile operator

Contact your OpenMarket account manager if you believe that you are provisioned for the operator or if you want to begin provisioning.


Short Message State: Mobile operator-dependent

Retryable: N/A

564

Short code blocked by mobile operator

The mobile operator rejected the message as the short code is currently blocked from sending messages across their network.

Contact The mobile operator rejected the message as the short code is currently blocked from sending messages across their network.

Contact your OpenMarket account manager if you are unaware of why you have received this error.

your OpenMarket account manager if you are unaware of why you have received this error.


Short Message State: Mobile operator-dependent

Retryable: No

565

End users connected to this MVNO cannot receive short code messages

The mobile operator rejected the message as the end user is connected to their network via a mobile virtual network operator (MVNO). This restriction is on short code messages.


Short Message State: Mobile operator-dependent

Retryable: No

566

Destination address blocked by mobile operator

The mobile operator is blocking the phone number from receiving messages from short codes. This is likely due to the end user's account being suspended or barred in some way.


Short Message State: Mobile operator-dependent

Retryable: N/A

568

Destination address not provisioned for SMS

Destination address not provisioned for SMS.


Short Message State: Mobile operator-dependent

Retryable: N/A

569 Destination address suspended by mobile operator Destination address suspended by mobile operator.

Short Message State: Mobile operator-dependent

Retryable: No
571 Program ID rejected by mobile operator

This error applies to messages sent to US mobile operators. The error indicates the program ID in the message request is not provisioned with the mobile operator.

Contact your account manager if you receive this error and believe that your program is provisioned and active.


Short Message State: Mobile operator-dependent

Retryable: N/A

572

Campaign is not provisioned for this mobile operator or is not active

This error applies to messages sent to US mobile operators. OpenMarket has determined (before forwarding the message) that thecampaign is not provisioned or is not currently active with the mobile operator.

Contact your account manager if you receive this error and believe that your program is provisioned and active.


Short Message State: REJECTD

Retryable: N/A

573

Short code blocked by end user

The end user has asked their mobile operator to block any messages sent from your short code. Additional messages from the same short code must not be sent to the phone number unless the end user opts in again.


Short Message State: Mobile operator-dependent

Retryable: No

574

New subscriptions for this short code are blocked by the mobile operator

Indicates that for a given short code, new subscribers are not allowed to receive or send messages. However, existing subscribers are still allowed to receive and send messages.

This error is returned by Sprint US and Virgin Mobile USA.

Contact your OpenMarket account manager if you are unaware of why you have received this error.



Short Message State: Mobile operator-dependent

Retryable: No

577

Account not provisioned to use SMS demo short code

Returned for US messaging only.

You have attempted to use an OpenMarket short code that is reserved for demoing US messaging.

Contact your account manager if you would like to try out US standard rate SMS using our demo short code.


Short Message State: REJECTD

Retryable: no

578

Exceeded the time limit for using SMS demo

You can use demo OpenMarket SMS messaging for a limited time only. Contact your OpenMarket account manager to extend your trial.


Short Message State: REJECTD

Retryable: no

579

Destination address not in whitelist for SMS demo

When demoing OpenMarket SMS messaging, you are limited to sending messages only to a whiltelist of mobile numbers you have told us you wish to message. The phone number you attempted to message is not on the whitelist.

Contact OpenMarket Support to add the phone number to the whitelist.


Short Message State: REJECTD

Retryable: no

580

Exceeded the max number of demo requests

You can only send a limited number of MT messages while demoing OpenMarket SMS messaging.

Contact your OpenMarket account manager if you wish to extend this limit.


Short Message State: REJECTD

Retryable: no

581

End user out of prepay credit

The end user does not have enough credit on their phone account to receive the message. You may retry every 24 hours for no more than seven days.


Short Message State: Mobile operator-dependent
Retryable: N/A

591

Exceeded the monthly limit on global MT messaging

You have reached the agreed MT message limit on your account for global one-way and two-way messaging.

Please contact your OpenMarket account manager if you want to discuss changing this limit.


Short Message State: REJECTD

Retryable: no

592 Account not provisioned for global one- or two-way SMS

The end user's number has a country code that is from a region of the world that you are not provisioned to reach. For example, if you exclusively message in the US or CA, you will not be provisioned for messaging end users who reside in other regions. If you'd like extend your messaging to reach end users globally, please contact your OpenMarket account manager.


Short Message State: REJECTD

Retryable: no

593

Cannot determine which message originator to use

The customer did not provide the MT source address, source address TON, and/or interaction, so the SMS application was not able to determine which source address and/or interaction value to apply to the MT. This can occur when more than one short code was provisioned for the same country as the country of the destination address. The application cannot arbitrarily choose one.


Short Message State: REJECTD

Retryable: No

597

Account has no provisioned address that can reach the destination

The source address is not passed, and the SMS application determines there is no appropriate provisioned source address for the destination associated with the customer account.


Short Message State: REJECTD

Retryable: No

598

Interaction not supported for message destination

Interaction is provided in the submitted MT. The SMS application determined the country of the destination address did not support the interaction: one-way (33) or two-way (39). For example, a two-way interaction was passed for a destination in India, but OpenMarket does not have a two-way route for India.


Short Message State: REJECTD

Retryable: No

599

Values conflict for source address and interaction

Your request specified an interaction and message originator that are incompatible. For example, you will receive this error if you specify two-way but your originator is an alphanumeric string—for example, ACME123.


Short Message State: REJECTD

Retryable: No

600

Mobile operator mobileOperatorID does not support WAP Push

A WAP push MT was submitted to a US or Canadian mobile subscriber, but the mobile operator either does not allow or does not support WAP Push. If you are trying to forward a URL to the end user using WAP Push, we suggest resending the URL as plain text in an SMS, as most smart phones will turn this into a hyperlink.


Short Message State: REJECTD

Retryable: No

601

Your account is not provisioned for global two-way SMS

The MT contains a two-way interaction. The MT destination address is global and not US or Canadian. The customer account is provisioned only for global one-way SMS.


Short Message State: REJECTD

Retryable: No

607 This message was identified as spam and cannot be delivered

The message was blocked by a spam filter and will not be delivered to the end user's handset. If you believe your message was falsely identified as spam, please submit a ticket to OpenMarket Support.


Short Message State: REJECTD

Retryable: no

628 Temporary handset failure

Communication to the end user failed, despite the end user's account being provisioned for SMS and the handset SMS-capable. This is typically a temporary failure -- for instance, the handset might be turned off or without coverage.


Short Message State: Mobile operator-dependentt

Retryable: yes

629 Destination address unable to receive SMS

Communication to the end user failed to due to either the handset not being SMS-capable or not provisioned for SMS.


Short Message State: Mobile operator-dependent

Retryable: no

630 Destination overload

The destination mobile operator currently is unable to deliver SMS messages due to high traffic.


Short Message State: Mobile operator-dependent

Retryable: yes

631 Mobile operator network error

The mobile operator network infrastructure has returned an error. This might be at either the Mobile Switching Server (MSC), Short Message Service Center (SMSC), or Home Location Register (HLR).


Short Message State: Mobile operator-dependent

Retryable: yes

632 SMS rejected by mobile operator for attempted destination address

The mobile operator is explicitly rejecting the request, possibly on the end user's behalf -- for example, the end user's handset might be set to Do Not Disturb (DND) or has been opted out of receiving service traffic.


Short Message State: Mobile operator-dependent

Retryable: yes

633 Message failed due to unknown mobile operator error

The mobile operator returned a generic error for an unexpected failure in message delivery.

 

Short Message State: Mobile operator-dependent

Retryable: no

810

Failed message delivery

The mobile operator accepted the message, but has informed OpenMarket that message delivery failed. The mobile operator does not want to allow retries. This message might be returned for a variety of reasons, for which the mobile operator has decided not to provide additional details.


Short Message State: UNDELIV

Retryable: No

811

Message expired before it reached handset

OpenMarket and the destination mobile operator attempted to deliver the message to the destination address for the MT validity period. If a validity period was not specified, MT delivery is generally retried for three days before expiring.


Short Message State: EXPIRED

Retryable: Yes

815

Message submitted to but not acknowledged by mobile operator

When OpenMarket sends a message to a mobile operator, we expect to receive an asynchronous reply confirming that the message was received. If we don't receive a response (and after using our retry strategy), then we will return this error to you. It is possible that the end user may have received one or more of the same message (or not received the message at all).


Short Message State: EXPIRED

Retryable: Yes

1010

Temporary error processing requests

This error is returned when OpenMarket was unable to process the finish processing the request. Your message was not sent. You can retry your request in intervals of 10 seconds or more, or contact OpenMarket Support if you continue to receive this error.


Short Message State: REJECTD

Retryable: Yes

1020

Temporary mobile operator system error

The mobile operator is experiencing an outage or system error that should resolve itself shortly. Retry is attempted every 24 hours for a period of seven days. For T-Mobile USA in particular, T-Mobile USA does not provide sufficient detail for OpenMarket to distinguish between the two potential causes for the 1020 response code.

  • A 1020 response for this carrier may either indicate a system error within T-Mobile USA or the following for the phone number.
  • Content Blocking/Blacklisting/Family Allowance is enabled. It is important to note the only way that Content Blocking, Blacklisting, or Family Allowance occurs is if the mobile subscriber called into T-Mobile customer care and specifically requested blocking of short code services.

Short Message State: Mobile operator-dependent

Retryable: No

1030

Non-retryable mobile operator system error

The mobile operator is experiencing an outage or system error during which they do not want messages retried. Check the system status as reported by OpenMarket via email and on Customer Center, and use a slow retry strategy to test for connectivity; e.g. one request attempt every 20 minutes.


Short Message State: Mobile operator-dependent

Retryable: No