All Status and Error Codes

Best practice with TeleSign APIs is to retrieve the status or error codes that come back in the responses and use these to code against rather than using an HTTP status.

Status codes in TeleSign APIs are three or four digits long. Some status codes are not final for a transaction. If you see one that says intermediate, it means the status code can resolve to another transaction. If you see one that says final, that status will not change again.

Error codes are five digits long.

Status CodeAssociated Text StringDescriptionAPI
100Call answeredThe call was answered by the end user or voicemail.Voice
101Not answeredNo one answered the call.Voice
103Call in progressThe call is in progress.Voice
104Wrong/invalid phoneThe phone number is not correctly formatted in some way, so a call cannot be placed.Voice
106Call failedThe call did not go through. Typically this occurs when TeleSign’s upstream providers fail to complete the call. Sometimes retrying will work.Voice
107Line busyThe line was busy when the call tried to reach the end user’s device.Voice
130Call blocked by TeleSignTeleSign blocks a message if it is being sent to a phone number that is on a global blocklist.Voice
200Delivered to handsetThe SMS was delivered to the end user's phone. (Final)SMS
203Delivered to gatewayThe SMS was delivered to the gateway. If the gateway responds with further information (including successful delivery to handset or delivery failure), the status is updated. (Intermediate)SMS
207Error delivering SMS to handset (reason unknown)The SMS could not be delivered to the end user's handset for an unknown reason. (Final)SMS
210Temporary phone errorThe SMS could not be delivered to the handset due to a temporary error with the phone. Examples - phone is turned off, not enough memory to store the message. (Final)SMS
211Permanent phone errorThe SMS could not be delivered to the handset due to a permanent error with the phone. For example, the phone is incompatible with SMS, or illegally registered on the network. This can happen when a phone number is blacklisted, or is incorrectly provisioned. (Final)SMS
220Gateway/network cannot route messageThe network cannot route the message to the handset. (Final)SMS
221Message expired before deliveryThe message was queued by the mobile provider and timed out before it could be delivered to the handset. (Final)SMS
222SMS not supportedSMS is not supported by this phone, carrier, plan, or user.SMS
230Message blocked by TeleSignTeleSign blocks a message if it is being sent to a phone number that is on a global blocklist.SMS
231Invalid/unsupportedThe content of the message is not supported.SMS
237Message blocked in requested countryYou requested that messages in a specific country be blocked, and the message was being sent to this country.SMS
238Destination blocked by prefixYou requested that phone numbers with a particular prefix be blocked.SMS
250Final status unknownThe final status of the SMS cannot be determined.SMS
251Message successfully sent out for delivery, however final confirmation of delivery to handset was not receivedThe message was successfully delivered to the gateway, but we cannot confirm delivery to the handset because we do not receive the final handset delivery receipts in this region. NOTE: There is a high probability that this message was successfully delivered to the handset.
286Transaction not attemptedThe SMS is blocked from being sent due to the phone type not being one of the following - mobile, prepaid, personal, or pager.SMS
290Message in progressThe message is being sent to the SMS gateway.SMS
292Queued by gatewayThe SMS gateway has queued the message.SMS
295Status delayedThe status of the SMS is temporarily unavailable.SMS
300Transaction successfully completedThe system was able to obtain all of the requested data for PhoneID.PhoneID, Score
301Transaction partially completedThe system was able to obtain some of the data for PhoneID, but not all of it.PhoneID, Score
500Transaction not attemptedNo SMS request was attempted.SMS
502Campaign errorThis error can be generated if there is a problem with the short code used.SMS
503Carrier rejected - temporary problemThis error is generated if there is an error on the carrier or operator side that is temporary and the message can be retried.SMS
504Carrier rejected - permanent errorThis error is generated if there is an error on the carrier or operator side that is permanent and the message should not be retried.SMS
505Error on gateway - temporary errorThis error is generated if there is an error on TeleSign's partner side that is considered temporary and the message can be retried.SMS
506Error on gateway - permanent errorThis error is generated if there is an error on TeleSign's partner side that is considered permanent and the message should not be retried.SMS
507Invalid destination addressThere is a problem with the destination address used. Either the format is not valid, or the number is not associated with any carrier, or if MSC is used it does not know about this MSISDN.SMS
508Invalid source addressThe message requires a source address. Verify that one is provided and correct.SMS
510Message blocked by subscriber action or requestThe end user has blocked receiving SMS with their carrier plan or by request or from the particular short code used.SMS
511Subscriber low on creditThe end user exceeded their spending limits and cannot receive SMS.SMS
512Roaming errorEnd user cannot receive SMS because their device that receives the messages is roaming.SMS
513Mobile number portability errorSMS failed because ported combinations are unreachable.SMS
514Subscriber absentThe operator/carrier is temporarily unable to reach the end user’s device.SMS
515Suspected spamThis message is considered to be spam by carrier or operator.SMS
599Status not availableThe system is unable to provide status at this time.SMS
Error CodeAssociated Text StringAPI
10002x-ts-nonce header value has been used recentlyAll
10003x-ts-nonce header is either too long or too shortAll
10003Insufficient funds in prepaid walletAll
10004Date or x-ts-date header is not within tolerable rangeAll
10005Date or x-ts-date header is not RFC822 compliantAll
10006Invalid x-ts-auth-method headerAll
10007Missing required Date or x-ts-date headerAll
10008Invalid signatureAll
10009Missing required Authorization headerAll
10009Invalid value for parameter messageAll
10010CustomerID Account SuspendedAll
10010Invalid value for parameter originating_ipPhoneID, Score, SMS, Voice
10011Invalid value for parameter reference_idAll
10012This feature is not enabled for this CustomerIDPhoneID, Score, SMS, Voice
10013Invalid Request. CustomerID Account Not FoundPhoneID, Score, SMS, Voice
10014Invalid source IP addressPhoneID, Score, SMS, Voice
10015Invalid customer IDPhoneID, Score, SMS, Voice
10017Customer ID / Reference ID not foundPhoneID, Score, SMS, Voice
10019Rate Limit ExceededPhoneID, Score, SMS, Voice
10020Messaging exceeded transaction hard cap. Request denied.PhoneID, Score, SMS, Voice
10030Insufficient funds in prepaid walletPhoneID, Score, SMS, Voice
10031Not allowed IP AddressSMS
10032Message blocked by TeleSignPhoneID, Score, SMS, Voice
10033Unverified phone_number requested for trial account.PhoneID, Score, SMS, Voice
10034Call with declared type blocked in country requestedSMS, Voice
10036Reference ID expiredSMS, Voice
11000Invalid value for parameter phone_numberPhoneID, Score, SMS, Voice
11001Invalid country code for parameter phone_numberPhoneID, Score, SMS, Voice
11002Invalid value for parameter account_id
11003Invalid value for parameter account_lifecycle_eventPhoneID, Score, SMS, Voice
11004Invalid value for parameter callback_urlSMS, Voice
11005Invalid value for parameter customer_idPhoneID, Score, SMS, Voice
11006Invalid value for parameter device_idScore
11007Invalid value for email_addressScore
11009Invalid value for parameter messageSMS, Voice
11010Invalid value for parameter originating_ipPhoneID, Score, SMS, Voice
11011Invalid value for parameter reference_idPhoneID, Score, SMS, Voice
11017Invalid value for parameter device_idSMS, Voice
12000Missing required parameter phone_numberPhoneID, Score, SMS, Voice
12003Missing required parameter account_lifecycle_eventScore
12009Missing required parameter messageSMS, Voice
12017Missing required parameter message_typeSMS, Voice

Did this page help you?