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
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
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)

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
-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?