All Status and Error Codes

With TeleSign APIs you need to code against the status or error codes that come back in the content of responses, rather than using the HTTP status code.

Status codes in TeleSign APIs are three- or four-digits long. Error codes are five digits long.

A transaction with an intermediate code may resolve to another status later. One with a final code will not change status in the future.

Status Codes

Status CodeAssociated Text StringDescriptionAPI
100Call answeredThe call was answered by the end user or voicemail.Voice Verify
101Not answeredNo one answered the call.Voice Verify
103Call in progressThe call is in progress. You get back an immediate response from TeleSign when you make a request, usually with this status. If you retrieve status info later, it will resolve to a different status code.Voice Verify
105Call not handled yetThe verification call has not yet been attempted.Voice Verify
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 Verify
107Line busyThe line was busy when the call tried to reach the end user’s device.Voice Verify
108Call canceled by TeleSignCall canceled by TeleSign.Voice Verify
129Call blocked by your requestTeleSign blocked the call before it was placed. This is due to your prior submitted request to blocklist this phone number.Voice Verify
130Call blocked by TeleSignTeleSign blocks a message if it is being sent to a phone number that is on a global blocklist.Voice Verify
200Delivered to handsetThe SMS was delivered to the end user's phone. FinalSMS, SMS Verify
201Message is readMessage read by end user. FinalMessaging
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. IntermediateSMS, SMS Verify
207Error delivering SMS to handset (reason unknown)The SMS could not be delivered to the end user's handset for an unknown reason. FinalSMS, SMS Verify
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. FinalSMS, SMS Verify
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. FinalSMS, SMS Verify
220Gateway/network cannot route messageThe network cannot route the message to the handset. FinalSMS, SMS Verify
221Message expired before deliveryThe message was queued by the mobile provider and timed out before it could be delivered to the handset. FinalSMS, SMS Verify
222SMS not supportedSMS is not supported by this phone, carrier, plan, or user.SMS, SMS Verify
229Message blocked by your requestThis code can happen because you requested a block or because TeleSign blocked on your behalf. The block is custom, meaning it applies to you and not others.
230Message blocked by TeleSignTeleSign blocks a message if it is being sent to a phone number that is on a global blocklist.SMS , SMS Verify
231Invalid/unsupportedThe content of the message is not supported.SMS, SMS Verify
233Message blocked due to high risk score.It was determined that the risk score for the destination number is higher than configured Maximum Risk Score. For that reason TeleSign did not send the SMS.SMS Verify
234Price threshold exceededMessage not sent due to the price exceeding your set maximum price.
237Message blocked in requested countryYou requested that messages in a specific country be blocked, and the message was being sent to this country.SMS, SMS Verify
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, SMS Verify
251Message successfully sent out for delivery, however final confirmation of delivery to handset was not received / MO successfully sent but 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.SMS, SMS Verify
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. You get back an immediate response from TeleSign when you make a request, usually with this status. If you retrieve status info later, it will resolve to a different status code.SMS, SMS Verify
291Queued by TeleSignTeleSign is experiencing an unusually high volume and has queued the SMS message.SMS, SMS Verify
292Queued by gatewayThe SMS gateway has queued the message.SMS, SMS Verify
295Status delayedThe status of the SMS is temporarily unavailable.SMS, SMS Verify
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 call, SMS, or PhoneID request was attempted.All
501Not authorizedNo permissions for this resource, or authorization failed.SMS Verify
502Campaign errorThis error can be generated if there is a problem with the short code used.SMS, SMS Verify
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, SMS Verify
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, SMS Verify
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, SMS Verify
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, SMS Verify
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, SMS Verify
508Invalid source addressThe message requires a source address. Verify that one is provided and correct.SMS, SMS Verify
509Parameters problemOne or more parameters used in the request is not supported.SMS, SMS Verify
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, SMS Verify
511Subscriber low on creditThe end user exceeded their spending limits and cannot receive SMS.SMS, SMS Verify
512Roaming errorEnd user cannot receive SMS because their device that receives the messages is roaming.SMS, SMS Verify
513Mobile number portability errorSMS failed because ported combinations are unreachable.SMS, SMS Verify
514Subscriber absentThe operator/carrier is temporarily unable to reach the end user's device.SMS, SMS Verify
515Suspected spamThis message is considered to be spam by carrier or operator.SMS, SMS Verify
516Delivery channel not supported by the end user's deviceThe end user's device does not support the channel used for delivery. FinalSMS, Messaging
517Selected DLT details for India not supportedThe DLT template ID or entity ID in the request cannot be found by the end operator.SMS, SMS Verify
518Message blocked due to high risk SIM swap indicator.The service determined that the SIM swap risk indicator for the destination number is higher than the maximum value configured for your account. For that reason TeleSign did not send the SMS.SMS Verify
519Message not sent - requested SIM swap check could not be performed.The service could not perform the SIM swap check. This is because either the number is out of SIM swap coverage or information about the potential SIM swap event is missing.SMS Verify
520Content sent is not allowedThe content in this message is not permitted by the carrier.SMS, SMS Verify
599Status not availableThe system is unable to provide status at this time.SMS, SMS Verify
2000PendingSmart Verify process attempted.Smart Verify
2028FailureBlocked - the risk score after running a Score check on the number is too high.Smart Verify
2400PendingApp Verify
2401SuccessApp Verify
2402FailureApp Verify
2403Not AttemptedApp Verify
2404Invalid Phone NumberApp Verify
2405Not SupportedApp Verify
2407CallerID prefix did not matchApp Verify
2408Unsupported phone typeThe App Verify API only works with Android phones. If you are trying to verify an emulator, a landline, or non-Android mobile phone, you may get this error.App Verify
2429Call blocked by customer requestYou can request that numbers be blocked.App Verify
2430Call blocked by TeleSignTeleSign blocks calls from numbers if the number is deemed suspicious.App Verify
2800Request successfully completedPhoneID (all add-ons)
2801Invalid request addons parameter: {parameter_name}PhoneID (all add-ons)
2802name of add-on add-on temporarily unavailable.PhoneID (all add-ons)
2803Phone number out of name of add-on add-on coverage.PhoneID (all add-ons)
2804Phone number not applicable in name of add-on add-on.PhoneID (all add-ons)
2805No name of add-on add-on information for phone number.PhoneID (all add-ons)
2806Name of add-on add-on is not enabled.PhoneID (all add-ons)
2807Some parameters submitted in the request are not valid.PhoneID (all add-ons)
2808Invalid Request: {parameter_name} parameter is missing or empty.PhoneID (all add-ons)
2809Billing Postal Code does not match contact_plus add-on information for phone number.PhoneID (Contact Plus add-on)
2810Request process failed during data collection.PhoneID (all add-ons)
2811Request processing time out.PhoneID (all add-ons)
2812name of add-on exceeded transaction hard cap. Request denied.PhoneID (all add-ons)
3000DeliveredThe message was delivered to the end-user. (Final if the last channel used doesn't support Read status. Intermediate otherwise)Messaging API
3001Message in progressTeleSign successfully received this message request and is processing it. (Intermediate)Messaging API
3002Delivered to GatewayThe message is in the process of delivery. Once all delivery options are exhausted, the status will be updated again. (Intermediate)Messaging API
3003Delivery errorThe message could not be delivered to the end-user. (Final)Messaging API
3004Message successfully sent out for delivery, however final confirmation of delivery to handset was not received / MO successfully sent but 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.Messaging API
3005Message is readThe message has been read by the end-user. (Final)Messaging API
3006None of the channels is enabled for the customerThe channels specified in this request are all either not enabled for this customer or are invalid values. (Final)Messaging API
3011Provider Account registration errorMessaging API
3012Provider Account migration errorMessaging API
3030Temporary phone errorThe message 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. FinalMessaging API
3031Permanent phone errorThe message 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. FinalMessaging API
3032Gateway/network cannot route messageThe network cannot route the message to the handset. FinalMessaging API
3033Message expired before deliveryThe message was queued by the mobile provider and timed out before it could be delivered to the handset. FinalMessaging API
3034SMS not supportedSMS is not supported by this phone, carrier, plan, or user.Messaging API
3035Invalid/unsupportedThe content of the message is not supported.Messaging API
3036Price threshold exceededMessage not sent due to the price exceeding your set maximum price.
3037Message blocked in requested countryYou requested that messages in a specific country be blocked, and the message was being sent to this country.Messaging API
3038Destination blocked by prefixYou requested that phone numbers with a particular prefix be blocked.Messaging API
3039Final status unknownThe final status of the SMS cannot be determined.Messaging API
3040Queued by gatewayThe SMS gateway has queued the message.Messaging API
3041Carrier 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.Messaging API
3042Carrier 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.Messaging API
3043Error 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.Messaging API
3044Error 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.Messaging API
3045Parameters problemOne or more parameters used in the request is not supported.Messaging API
3046Message 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.Messaging API
3047Subscriber low on creditThe end user exceeded their spending limits and cannot receive SMS.Messaging API
3048Roaming errorEnd user cannot receive SMS because their device that receives the messages is roaming.Messaging API
3049Mobile number portability errorSMS failed because ported combinations are unreachable.Messaging API
3050Subscriber absentThe operator/carrier is temporarily unable to reach the end user's device.Messaging API
3051Suspected spamThis message is considered to be spam by carrier or operator.Messaging API
3052Message blocked by your requestThis code can happen because you requested a block or because TeleSign blocked on your behalf. The block is custom, meaning it applies to you and not others.Messaging API
3053Message blocked by TeleSignTeleSign blocks a message if it is being sent to a phone number that is on a global blocklist.Messaging API
3054Delivery channel not supported by the end user's deviceThe end user's device does not support the channel used for delivery. FinalMessaging API
3055Error 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.Messaging API
3056Message failed to deliver in specified fallback timeDelivery could not be confirmed on this channel within the fallback window; triggers the next channel (if any) to send. (Intermediate)Messaging API
3057Invalid source addressThe message requires a source address. Verify that one is provided and correct.Messaging API
3058The requested API host is not allowed for this customer_idMessaging API
3059Exceeded number of elements for rich cardMessaging API
3061Media size exceeds the limitMessaging API
3062MMS not supportedMessaging API
3071Unverified phone_number requested for trial account.Messaging API
3073Insufficient funds in prepaid walletMessaging API
3100Unknown channel specified: {channel}This channel specified in the request is not one of the supported values; triggers the next channel (if any) to send. (Intermediate)Messaging API
3101Invalid value for parameter phone_number: {phone_number}Phone number is too long, too short, or contains non-digit values. (Intermediate)Messaging API
3102Invalid value for parameter message_type: {message_type}The value of parameter message_type is not one of the supported values: ARN, MKT, OTP. (Final)Messaging API
3103Unsupported value for parameter external_id: {external_id}The value of parameter external_id is longer than 100 or contains non-ASCII characters. (Final)Messaging API
3104Invalid value for parameter account_lifecycle_event: {account_lifecycle_event}The value of parameter account_lifecycle_event is not one of the supported values: create, sign-in, transact, update, delete. (Final)Messaging API
3105Invalid value for parameter originating_ip: {originating_ip}Parameter originating_ip is improperly formatted. (Final)Messaging API
3106Invalid value for parameter callback_url: {callback_url}The value of parameter callback_url is empty. (Final)Messaging API
3107Invalid country code for parameter phone_numberMessaging API
3108Invalid value for parameter messageMessaging API
3109Invalid value for parameter sender_idMessaging API
3110Invalid requestThe API request or its JSON payload is improperly formatted. (Final)Messaging API
3112Specified template does not exist for selected channelMessaging API
3113Invalid value for parameter channel: {channels}The value of the parameter channels contains the same channel more than once or is improperly formatted. (Final)Messaging API
3114Specified message type not allowed outside of conversation windowMessaging API
3115Destination phone number not in coverageMessaging API
3200{channel} channel is not enabled for customerThis channel is not enabled for this customer. (Intermediate)Messaging API
3202Fallback is not enabled for Customer IDMultiple channels are specified in the request, but fallback is not enabled for this customer. (Intermediate)Messaging API
3203Callback URL parameter not enabled for Customer IDUsing callback_url in the API request is not allowed for this customer. (Final)Messaging API
3204Rate limit exceededAllowed number of requests per second on Omnichannel API has been exceeded. (Final)Messaging API
3205Rate Limit ExceededMessaging API
3206Omnichannel Product not enabled for Customer IDOmnichannel product is not enabled for this customer. (Final)Messaging API
3207Messaging exceeded transaction hard cap. Request denied.Messaging API
3208Provider Account ID not foundMessaging API
3209Phone number not registered for testingMessaging API
3300Missing parameter channelsThe API request does not contain mandatory parameter channels. (Final)Messaging API
3301Missing parameter channelThe value of the parameter channels does not contain any instances of the mandatory sub-property channel. (Final)
3302Missing parameter phone_numberThe API request does not contain the mandatory parameter phone_number. (Final)Messaging API
3303Missing parameter messageThe API request does not contain the mandatory parameter message. (Final)Messaging API
3304Missing parameter message_typeThe API request does not contain the mandatory parameter message_type. (Final)Messaging API
3305Missing template specific parametersMessaging API
3306Missing message parameters for specified channelMessage object doesn't contain required info for sending message through selected channel. (Intermediate)Messaging API
3400Not authorizedNo permissions for this resource or authorization failed. (Final)Messaging API
3405Missing required Authorization headerMessaging API
3406CustomerID Account SuspendedMessaging API
3408CustomerID Account Not FoundMessaging API
3409Invalid source IP addressMessaging API
3410Invalid Customer IDMessaging API
3411Invalid API KeyMessaging API
3412Required Authorization header is not in the correct formatMessaging API
3413Not Allowed IP AddressMessaging API
3500System UnavailableThe system is currently unavailable. The request should be resubmitted. (Final)Messaging API
3601CustomerID Account Not FoundMessaging API

Error Codes

Error CodeDescriptionAPI
-10001Invalid Request: {parameter name}: {parameter value}SMS Verify
-10001Missing Parameter: {parameter name}SMS Verify
-10001Invalid parameter passedSMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-10001CustomerId/RefID not foundSMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-10004Reference ID expiredGet Status, Completion
-10009Invalid source IP addressSMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-20001Invalid requestSMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-20002This product is not enabled for this CustomerIDSMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-20003This feature is not enabled for this Customer ID.SMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-20,004This product is not enabled for this country.SMS Verify, Voice Verify
-30000Invalid CustomerIDSMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30001Account suspendedSMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30002Account not activatedSMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30003Account limit reachedSMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30004Missing required 'Authorization' headerSMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30005Required Authorization header is not in the correct formatSMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30006Invalid signatureSMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30007Missing required 'Date' or 'x-ts-date' headerSMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30008Invalid X-TS-Auth-Method headerSMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30009Date or X-TS-Date header is not RFC822 compliantSMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30010'Date' or 'x-ts-date' header is not within tolerable rangeSMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30011X-TS-Nonce header value is either too long or too shortSMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30012'x-ts-nonce' header value has been used recentlySMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30013Invalid ReferenceID for Verify CompletionCompletion, Get Status
-30014Invalid App Verify API finalizeApp Verify API
-40001Status unavailableGet Status
-40002Not authorizedSMS Verify, Voice Verify, Number Deactivation, Smart Verify
-40004Resource not foundSMS Verify, Voice Verify, Number Deactivation, Smart Verify
-40005Method not allowedSMS Verify, Voice Verify, Number Deactivation, Smart Verify
-40007Rate limit exceededSMS Verify, Voice Verify, Number Deactivation, Smart Verify
-40008[Product method] exceed transaction hard cap; Request deniedSMS Verify, Voice Verify, Number Deactivation, Smart Verify
-40009Phone number not supportedSMS Verify, Voice Verify, Number Deactivation, Smart Verify
-40022App Verify API not supportedApp Verify API
-40023Number Deactivation
-40025Message blocked by TeleSignBulk SMS API
-50001Max retries limit reachedSMS Verify, Voice Verify, Number Deactivation, Smart Verify
-50002Mobile 2FA registration errorSMS Verify, Voice Verify, Number Deactivation, Smart Verify
-50003Mobile device stamp drift too largeSMS Verify, Voice Verify, Number Deactivation, Smart Verify
-50051Invalid hashcash submittedSMS Verify, Voice Verify, Number Deactivation, Smart Verify
-50052Unmatched registration initiate requestSMS Verify, Voice Verify, Number Deactivation, Smart Verify
-50054Invalid API keySMS Verify, Voice Verify, Number Deactivation, Smart Verify
-50055Inactive API keySMS Verify, Voice Verify, Number Deactivation, Smart Verify
-50056Inactive applicationSMS Verify, Voice Verify, Number Deactivation, Smart Verify
-50057Invalid verification codeSMS Verify, Voice Verify, Number Deactivation, Smart Verify
-50058Application is not registered for push notificationSMS Verify, Voice Verify, Number Deactivation, Smart Verify
-50059Status not available
-60001PhoneID Contact data not foundPhoneID
-60002Mobile 2FA registration warningSMS Verify, Voice Verify, Number Deactivation, Smart Verify
-90001System unavailable; please try again laterSMS Verify, Voice Verify, Number Deactivation, Smart Verify
10000System unavailable, please try again laterSMS
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 headerSMS
10008Invalid signatureAll
10009Missing required Authorization headerAll
10009Invalid value for parameter messageSMS
10010CustomerID Account SuspendedAll
10011Invalid value for parameter reference_idAll
10012This feature is not enabled for this CustomerIDPhoneID, Score, SMS
10013Invalid Request. CustomerID Account Not FoundPhoneID, Score, SMS
10014Invalid source IP addressPhoneID, Score, SMS
10015Invalid Customer IDPhoneID, Score, SMS
10017Customer ID / Reference ID not foundPhoneID, Score, SMS
10019Rate Limit ExceededPhoneID, Score, SMS
10020Messaging exceeded transaction hard cap. Request denied.PhoneID, Score, SMS
10021The product is not enabled for this country.SMS
10022Invalid API KeySMS
10028Required Authorization header is not in the correct formatSMS
10030Insufficient funds in prepaid walletPhoneID, Score, SMS, Voice
10031Not Allowed IP AddressSMS
10032Request blocked due to this number appearing on a TeleSign blocklist.PhoneID, Score, SMS
10033Unverified phone_number requested for trial account.PhoneID, Score, SMS
10034Call with declared type blocked in country requestedSMS
10035The requested API host is not allowed for this customer_idSMS
10036Reference ID expiredSMS
11000Invalid value for parameter phone_numberPhoneID, Score, SMS
11001Invalid country code for parameter phone_numberPhoneID, Score, SMS
11002Invalid value for parameter account_id
11003Invalid value for parameter account_lifecycle_eventPhoneID, Score, SMS
11004Invalid value for parameter callback_urlSMS
11005Invalid value for parameter customer_idPhoneID, Score, SMS
11006Invalid value for parameter device_idScore
11007Invalid value for email_addressScore
11009Invalid value for parameter messageSMS
11010Invalid value for parameter originating_ipPhoneID, Score, SMS
11011Invalid value for parameter reference_idPhoneID, Score, SMS
11013Invalid value for parameter sender_idSMS
11016Invalid value for parameter external_idSMS
11017Invalid value for parameter device_idSMS
11034Invalid value for parameter dlt_template_idSMS
11035Invalid value for parameter dlt_entity_idSMS
12000Missing required parameter phone_numberPhoneID, Score, SMS
12003Missing required parameter account_lifecycle_eventScore
12009Missing required parameter messageSMS
12017Missing required parameter message_typeSMS

Did this page help you?