Home > Response Codes

Response Codes

For response codes returned by version 4 of the HTTP SMS API, see the Global SMS v4 API Guide.

Code Message Notes Retry Logic Category Retryable
0 Message sent OpenMarket successfully sent the message to the carrier's network. Retry Prohibited SMS Messaging No
1 Processing request Retry Prohibited SMS Messaging No
2 Message accepted SMS Messaging Conditional
3 Message buffered with carrier and waiting for a response Retry Prohibited SMS Messaging No
4 Message delivered The carrier successfully delivered the message to the end user. Retry Prohibited SMS Messaging No
301 Only one top level request element is permitted Retry Prohibited SMS Messaging No
303 The required version attribute of the request element was not found in the request Retry Prohibited SMS Messaging No
304 The required protocol attribute of the request element was not found in the request Retry Prohibited SMS Messaging No
306 The XML POST parameter cannot be empty Retry Prohibited SMS Messaging No
307 The request was an ill-formed XML document Common cause would be setting a url_encoded content-type, missing parameters or incorrect syntax in the XML Retry Prohibited SMS Messaging No
321 Invalid request version Retry Prohibited SMS Messaging No
322 Invalid request protocol Retry Prohibited SMS Messaging No
323 Invalid request type Retry Prohibited SMS Messaging No
339 Carrier ID is not an integer. The carrier ID is not an integer, or the carrier ID attribute was submitted with a null value. Retry Prohibited SMS Messaging No
341 Transaction failed; Carrier ID does not exist Verify the carrier ID used in the message submitted to OpenMarket. Retry Prohibited SMS Messaging No
345 Unable to determine carrier ID from destination address Number not associated with a carrier our system supports. Verify from MO SMS if possible. Please contact OpenMarket support for further information. Retry Prohibited SMS Messaging No
349 Destination address contains non-numeric characters Double check your numbers for improper input Retry Prohibited SMS Messaging No
350 A destination address is required Check the destination address against the OpenMarket Deactivated Numbers Reports; if the number is listed you cannot resubmit the billing to the destination address unless you receive an opt-in from a wireless subscriber Retry Prohibited SMS Messaging No
351 Transaction failed: Invalid destination address value Error 351 occurs in two general scenarios: 1. The 351 error is returned in the response to an MT submit. In this scenario the destination address in the message was not provided or was not properly formatted. 2. The 351 error is returned in a delivery receipt or in response to a Query API call. In this scenario, the 351 error can have multiple meanings, some of which are dependent upon the destination mobile operator: * The destination address does not belong to the mobile operator. * For US operators AT&T, T-Mobile, and MetroPCS, the error may also mean the phone number belongs to a prepaid user who does not have sufficient credits to receive an SMS message. * For US operator T-Mobile, the error may mean the end user is not provisioned to receive SMS from all short codes or specific short codes. Additionally, T-Mobile US does not deliver short code SMS to any of its resellers' numbers. You will receive this error if you attempt to send a short code MT to a T-Mobile reseller number. A reasonable course of action would be to retry using a US long code as the MT source address. * For US destination addresses, it is possible the phone number is deactivated. Check the "Deact" reports on Customer Center. * Global SMS: In most cases OpenMarket does not receive information from global operators to further refine the error case. In general, mobile operators do not want SMS senders to retry MT messages, which have failed with OpenMarket error 351. However, given the range of different possible root causes, OpenMarket does not think is it unreasonable to retry. For example, retry once every day over the course of 7 days. The first check you should make for US and Canada phone numbers follows: Submit a preview request to verify the carrier ID. If the response indicates a carrier ID other than the one used in the MT (resulting in the 351 error), resubmit the MT to the new carrier. SMS Messaging Conditional
352 Invalid destination address country code This error occurs in MTs when the country calling code of the destination address does not match the country provisioned for the source address. This error also occurs if a standard rate (charge type 0) MT is submitted to a destination address outside of the US and Canada. Retry Prohibited SMS Messaging No
353 Message text or data is required Cannot send blank messages Retry Prohibited SMS Messaging No
354 Message text is not long enough Cannot send blank messages Retry Prohibited SMS Messaging No
355 Message text is too long If the mlc option was submitted with a value of 0 or the default value of 0 is applied, the submitted message will be rejected if the message text or data length is greater than the maximum single segment message length allowed: generally 160 characters for 7BIT datacoding and 70 characters for the UCS2 datacoding. Retry Prohibited SMS Messaging No
358 Message from is too long Message requires a source address, verify one is provided, and is correct Retry Prohibited SMS Messaging No
365 Strict international addressing is enforced, please use a country code + national number Ensure you address are set with the proper source types, most likely use TON = 1 and begin the number with the destination country code. Retry Prohibited SMS Messaging No
366 Invalid message length control option There are only 3 valid values for this option: 0, 1 and 2 Retry Prohibited SMS Messaging No
367 Invalid source TON value Source ton most likely needs to be 3 when using short codes, 1 when using long codes Retry Prohibited SMS Messaging No
368 Invalid source address value Message requires a source address, verify one is provided, and is correct for the locale of the destination address. Retry Prohibited SMS Messaging No
369 Account not permitted to use an alphanumeric source address Retry Prohibited SMS Messaging No
370 Account not permitted to use a short code source address This most likely indicates an account provisioning issue. Check with OpenMarket Retry Prohibited SMS Messaging No
373 Invalid destination TON value Ensure that your Destination TON value equals 1 or 0 (international or unknown) for phone numbers Retry Prohibited SMS Messaging No
374 Preview lookup request failed Preview may have timed out, reattempt, contact support if persistent Retry Prohibited SMS Messaging No
375 Source address denied Account not configured to send from this short code, ensure correct account or contact support Retry Prohibited SMS Messaging No
376 Account not permitted to use premium billing options Premium SMS is no longer supported. Retry Prohibited SMS Messaging No
377 Invalid SMS charge type Charge type must be either 0 for US and Canada standard rate SMS, or 20 for international SMS. Retry Prohibited SMS Messaging No
378 Invalid premium billing charge amount Account not configured to send charge amount, possible currency issue Retry Prohibited SMS Messaging No
379 Invalid user data header Retry Prohibited SMS Messaging No
380 Invalid data coding scheme The value of the datacoding attribute submitted in the message is not a supported value. Retry Prohibited SMS Messaging No
381 Invalid characters used with selected data coding scheme Retry Prohibited SMS Messaging No
382 Invalid source or destination port Retry Prohibited SMS Messaging No
383 Message data and text attributes cannot be used at same time If sending data, no text can be sent Retry Prohibited SMS Messaging No
384 Invalid message data Retry Prohibited SMS Messaging No
388 Binary messaging is not supported for this carrier Carrier does not support WAP push or similar data transfer Retry Prohibited SMS Messaging No
397 WAP Pushes require the optional URL parameter to be included Retry Prohibited SMS Messaging No
398 WAP Pushes not supported for this type of carrier Retry Prohibited SMS Messaging No
420 Invalid account ID or account password account ID and password do not match, please double check both Retry Prohibited SMS Messaging No
431 Invalid account ID Account ID incorrect, or formatted incorrectly Retry Prohibited SMS Messaging No
432 Account access permanently blocked Your account has been blocked, please consult your sales rep for more information Retry Prohibited SMS Messaging No
433 Account access denied Retry Prohibited SMS Messaging No
451 Account mobile originated deliver profile incorrectly setup Contact OpenMarket Support if you see this error in your OpenMarket SMS reports. SMS Messaging No
540 Invalid Request - <details about the parameter in error> The response message <details> varies depending on the input parameter in error. No SMS Messaging No
560 Message recipient not authorized by carrier to receive the message Retry Prohibited SMS Messaging No
561 Content blocked by carrier This error usually occurs for Verizon MTs in cases where the content rating assigned by Verizon to the short code is not compatible with the content filtering rating on the mobile subscriber's account. Retry Prohibited SMS Messaging No
562 Short code not active Retry Prohibited SMS Messaging No
563 Short code expired Retry Prohibited SMS Messaging No
564 Short code blocked Retry Prohibited SMS Messaging No
565 Reseller address blocked by carrier Retry Prohibited SMS Messaging No
566 Destination address blocked by carrier Retry Prohibited SMS Messaging No
568 Destination address not provisioned for SMS Verizon numbers only. Consumer''s rate plan does not include SMS. Retry Prohibited SMS Messaging No
569 Destination address suspended by carrier Verizon numbers only. Destination address suspended by carrier. Retry Prohibited SMS Messaging No
570 Invalid charge amount: charge amount not allowed for charge type Customer submitted an MT with charge type 20 and included a charge amount. Retry Prohibited SMS Messaging No
571 Campaign rejected by carrier Retry only if and when the campaign has been corrected with the carrier. Contact your account manager if you receive this error. SMS Messaging No
572 Campaign information is not provisioned for this carrier or is not active. Retry only if and when the campaign or program ID has been corrected. SMS Messaging No
573 Short code blocked by subscriber Applies to failed messages where the subscriber has asked to have the short code blocked from their phone number. Additional messages from the same short code may not be sent to the phone number unless the subscriber opts in again. SMS Messaging No
574 Subscribers are not allowed to receive or send messages on this short code. Indicates that for a given short code, new subscribers are not allowed to receive or send messages. This error returned by Sprint and Virgin Mobile USA. SMS Messaging No
575 Account not permitted to submit preview requests SMS Messaging No
576 Campaign blocked SMS Messaging No
577 US SMS Demo Product required for this short code Contact your account manager for a demo of US standard rate SMS. SMS Messaging No
578 Demo product expired The SMS demo you are using for US or International SMS has expired. Contact your account manager. SMS Messaging No
579 Destination address not provisioned for this demo product Contact OpenMarket Support to provision the phone number to use with the demo product. SMS Messaging No
580 Demo product transaction limit exceeded If you are using an SMS demo, you have reached the limit of MTs you can send with the demo. If you are using the Preview Lookup demo, you have reached the limit of Preview Lookups available for the demo. Contact your account manager. SMS Messaging No
581 Prepaid subscriber out of credits You may retry every 24 hours for no more than seven days. SMS Messaging Yes
588 Invalid T-Mobile US subscriber. Possible causes: out of credits, suspended, content blocked, or not a T-Mobile subscriber Retry Prohibited SMS Messaging No
590 Invalid purpose for India SMS See the OpenMarket SMS Integration Guides section titled "Sending SMS messages to end users in India". SMS Messaging No
591 Monthly MT limit exceeded You may contact your account manager if you would like to increase your monthly international MT limit. SMS Messaging No
592 Your account is not provisioned for international SMS You may contact your account manager if you would like to sign up for international SMS. SMS Messaging No
603 Content blocked by user opt-out (MO: STOP) This code can be returned in a delivery receipt for an MT originating from a North American SMS-enabled toll free number or SMS-enabled US land line number. Messaging may resume to the end user if the end user opts back in to your content. Messaging No
700 Invalid number of ticket elements in request This error is returned in the SMS V3 HTTP Query API if more than one ticket is sent in the request. Messaging No
711 Ticket ID does not exist. SMS Messaging No
810 Failed message delivery All Carriers--Failed message delivery: retry prohibited. Text message delivery failed. SMS Messaging No
811 Message Delivery Error - Message expired OpenMarket and the destination mobile operator attempted to deliver the message to the destination address for the duration of the MT validity period. If you did not supply a validity period in the MT, MT delivery is generally retried for three days before expiring the MT. SMS Messaging Yes
815 Message Delivery Error - Message submitted to but not acknowledged by carrier Retry permitted for US Standard Rate and international SMS SMS Messaging Yes
1000 System error: General error occurred while processing request Retry Prohibited System No
1010 Temporary internal system error System Yes
1020 Temporary external system error If retries fail beyond the recommended retry period please contact OpenMarket Support for assistance troubleshooting. All Carriers: Retry every 24 hours for a period of seven days. T-Mobile USA: A 1020 response for 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 family allowance; content blocking or blacklisting occurs is if the mobile subscriber called into T-Mobile customer care and specifically requested blocking of short code services. T-Mobile USA does not provide sufficient detail for OpenMarket to distinguish between the two potential causes for the 1020 response code. System Yes
1030 External system error Retry Prohibited System No
3041 US standard rate message blocked by the OpenMarket deactivated numbers firewall Occurs when a US standard rate SMS message is sent to a deactivated number. SMS Messaging No
6500 Invalid request - Messaging No
6501 Account not enabled for service. Number Profile No
6502 Invalid request - Invalid phone number Number Profile No
6503 Unable to determine carrierId Number Profile No
6504 Carrier not supported Number Profile No
6505 Phone number not found with carrier Number Profile No
6509 Invalid request - HTTP method is not allowed. Number Profile No
6510 Invalid request - Not a valid API version: Number Profile No
6511 Invalid request - Unsupported query parameter: Number Profile No
6512 Invalid request - Invalid carrierId Number Profile No
6513 Invalid request - Invalid types Number Profile No
6514 No device info found Number Profile No
6515 Invalid request - Missing types Number Profile No
6520 Permission denied to external system. Number Profile No
6522 Response exceeded maximum timeout. Number Profile Yes
6524 Account not enabled for infoTypes (list of infoTypes) Number Profile No