Authentication
Try the API Explorer
APIs
SMS API
SMS Verify API
Bulk SMS API
Anonymous SMS API
Voice API
Voice Verify API
Phone Numbers API
PhoneID API
Score API
App Verify API
Get Status API
Completion API

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

Status Code Associated Text String Description API
100 Call answered The call was answered by the end user or voicemail. Voice, Voice Verify
101 Not answered No one answered the call. Voice, Voice Verify
103 Call in progress The call is in progress. Voice, Voice Verify
104 Wrong/invalid phone The phone number is not correctly formatted in some way, so a call cannot be placed. Voice
105 Call not handled yet The verification call has not yet been attempted. Voice Verify
106 Call failed The call did not go through. Typically this occurs when TeleSign’s upstream providers fail to complete the call. Sometimes retrying will work. Voice, Voice Verify
107 Line busy The line was busy when the call tried to reach the end user’s device. Voice, Voice Verify
108 Call canceled by TeleSign Call canceled by TeleSign. Voice Verify
129 Call blocked by your request TeleSign blocked the call before it was placed. This is due to your prior submitted request to blocklist this phone number. Voice Verify
130 Call blocked by TeleSign TeleSign blocks a message if it is being sent to a phone number that is on a global blocklist. Voice, Voice Verify
200 Delivered to handset The SMS was delivered to the end user’s phone. (Final) SMS, SMS Verify
203 Delivered to gateway The 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, SMS Verify
207 Error delivering SMS to handset (reason unknown) The SMS could not be delivered to the end user’s handset for an unknown reason. (Final) SMS, SMS Verify
210 Temporary phone error The 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, SMS Verify
211 Permanent phone error The 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, SMS Verify
220 Gateway/network cannot route message The network cannot route the message to the handset. (Final) SMS, SMS Verify
221 Message expired before delivery The message was queued by the mobile provider and timed out before it could be delivered to the handset. (Final) SMS, SMS Verify
222 SMS not supported SMS is not supported by this phone, carrier, plan, or user. SMS, SMS Verify
229 Message blocked by your request TeleSign blocked the SMS before it was sent. This is due to your prior submitted request to blocklist this phone number.
230 Message blocked by TeleSign TeleSign blocks a message if it is being sent to a phone number that is on a global blocklist. SMS , SMS Verify
231 Invalid/unsupported The content of the message is not supported. SMS, SMS Verify
232 Message blocked due to number deactivation event It was determined that the destination number was found and/or reported as deactivated from the data stream provider. This number deactivation event occurred within the deactivation lookup window, and after the last valid activity of the end user was recorded on your side. SMS Verify
233 Message 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
237 Message blocked in requested country You requested that messages in a specific country be blocked, and the message was being sent to this country. SMS
238 Destination blocked by prefix You requested that phone numbers with a particular prefix be blocked. SMS
250 Final status unknown The final status of the SMS cannot be determined. SMS, SMS Verify
251 Message successfully sent out for delivery, however final confirmation of delivery to handset was not received The 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
286 Transaction not attempted The SMS is blocked from being sent due to the phone type not being one of the following - mobile, prepaid, personal, or pager. SMS
290 Message in progress The message is being sent to the SMS gateway. SMS, SMS Verify
291 Queued by TeleSign TeleSign is experiencing an unusually high volume and has queued the SMS message. SMS, SMS Verify
292 Queued by gateway The SMS gateway has queued the message. SMS, SMS Verify
295 Status delayed The status of the SMS is temporarily unavailable. SMS, SMS Verify
300 Transaction successfully completed The system was able to obtain all of the requested data for PhoneID. PhoneID, Score
301 Transaction partially completed The system was able to obtain some of the data for PhoneID, but not all of it. PhoneID, Score
500 Transaction not attempted No SMS request was attempted. All
501 Not authorized No permissions for this resource, or authorization failed. SMS Verify
502 Campaign error This error can be generated if there is a problem with the short code used. SMS, SMS Verify
503 Carrier rejected - temporary problem This 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
504 Carrier rejected - permanent error This 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
505 Error on gateway - temporary error This 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
506 Error on gateway - permanent error This 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
507 Invalid destination address There 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
508 Invalid source address The message requires a source address. Verify that one is provided and correct. SMS, SMS Verify
509 Parameters problem One or more parameters used in the request is not supported. SMS, SMS Verify
510 Message blocked by subscriber action or request The end user has blocked receiving SMS with their carrier plan or by request or from the particular short code used. SMS, SMS Verify
511 Subscriber low on credit The end user exceeded their spending limits and cannot receive SMS. SMS, SMS Verify
512 Roaming error End user cannot receive SMS because their device that receives the messages is roaming. SMS, SMS Verify
513 Mobile number portability error SMS failed because ported combinations are unreachable. SMS, SMS Verify
514 Subscriber absent The operator/carrier is temporarily unable to reach the end user’s device. SMS, SMS Verify
515 Suspected spam This message is considered to be spam by carrier or operator. SMS, SMS Verify
599 Status not available The system is unable to provide status at this time. SMS, SMS Verify
2000 Pending Smart Verify attempted. Smart Verify
2028 Failure Blocked - risk score too high. Smart Verify
2400 Pending App Verify API
2401 Success App Verify API
2402 Failure App Verify API
2403 Not Attempted App Verify API
2404 Invalid Phone Number App Verify API
2405 Not Supported App Verify API
2407 CallerID prefix did not match App Verify API
2408 Unsupported phone type App Verify API
2429 Call blocked by customer request App Verify API
2430 Call blocked by TeleSign App Verify API

Error Codes

Error Code Associated Text String API
-10001 Invalid parameter passed SMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-10001 CustomerId/RefID not found SMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-10004 Reference ID expired Get Status, Completion
-10009 Invalid source IP address SMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-20001 Invalid request SMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-20002 This product is not enabled for this CustomerID SMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-20003 SMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30000 Invalid CustomerID SMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30001 Account suspended SMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30002 Account not activated SMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30003 Account limit reached SMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30004 Missing required Authorization SMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30005 Required Authorization header is not in the correct format SMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30006 Invalid signature SMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30007 Missing required Date or X-TS-Date header SMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30008 Invalid X-TS-Auth-Method header SMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30009 Date or X-TS-Date header is not RFC822 compliant SMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30010 Date or X-TS-Date header is not within tolerable range SMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30011 X-TS-Nonce header value is either too long or too short SMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion
-30013 Invalid ReferenceID for Verify Completion Completion, Get Status
-40001 Status unavailable Get Status
-40002 Not authorized SMS Verify, Voice Verify, Number Deactivation, Smart Verify
-40004 Resource not found SMS Verify, Voice Verify, Number Deactivation, Smart Verify
-40005 Method not allowed SMS Verify, Voice Verify, Number Deactivation, Smart Verify
-40007 Rate limit exceeded SMS Verify, Voice Verify, Number Deactivation, Smart Verify
-40008 [Product method] exceed transaction hard cap; Request denied SMS Verify, Voice Verify, Number Deactivation, Smart Verify
-40009 Phone number not supported SMS Verify, Voice Verify, Number Deactivation, Smart Verify
-40010 Number Deactivation
-40011 Number Deactivation
-40015 Number Deactivation
-40016 Number Deactivation
-40017 Number Deactivation
-40018 Number Deactivation
-40019 Number Deactivation
-40020 Number Deactivation
-40022 App Verify API
-40023 Number Deactivation
-50001 Max retries limit reached SMS Verify, Voice Verify, Number Deactivation, Smart Verify
-50002 Mobile 2FA registration error SMS Verify, Voice Verify, Number Deactivation, Smart Verify
-50003 Mobile device stamp drift too large SMS Verify, Voice Verify, Number Deactivation, Smart Verify
-50051 Invalid hashcash submitted SMS Verify, Voice Verify, Number Deactivation, Smart Verify
-50052 Unmatched registration initiate request SMS Verify, Voice Verify, Number Deactivation, Smart Verify
-50054 Invalid API key SMS Verify, Voice Verify, Number Deactivation, Smart Verify
-50055 Inactive API key SMS Verify, Voice Verify, Number Deactivation, Smart Verify
-50056 Inactive application SMS Verify, Voice Verify, Number Deactivation, Smart Verify
-50057 Invalid verification code SMS Verify, Voice Verify, Number Deactivation, Smart Verify
-50058 Application is not registered for push notification SMS Verify, Voice Verify, Number Deactivation, Smart Verify
-60001 PhoneID Contact data not found SMS Verify, Voice Verify, Number Deactivation, Smart Verify
-60002 Mobile 2FA registration warning SMS Verify, Voice Verify, Number Deactivation, Smart Verify
-90001 System unavailable; please try again later SMS Verify, Voice Verify, Number Deactivation, Smart Verify
10002 x-ts-nonce header value has been used recently All
10003 x-ts-nonce header is either too long or too short All
10003 Insufficient funds in prepaid wallet All
10004 Date or x-ts-date header is not within tolerable range All
10005 Date or x-ts-date header is not RFC822 compliant All
10006 Invalid x-ts-auth-method header All
10007 Missing required Date or x-ts-date header All
10008 Invalid signature All
10009 Missing required Authorization header All
10009 Invalid value for parameter message Voice, SMS
10010 CustomerID Account Suspended All
10010 Invalid value for parameter originating_ip PhoneID, Score, SMS, Voice
10011 Invalid value for parameter reference_id All
10012 This feature is not enabled for this CustomerID PhoneID, Score, SMS, Voice
10013 Invalid Request. CustomerID Account Not Found PhoneID, Score, SMS, Voice
10014 Invalid source IP address PhoneID, Score, SMS, Voice
10015 Invalid customer ID PhoneID, Score, SMS, Voice
10017 Customer ID / Reference ID not found PhoneID, Score, SMS, Voice
10019 Rate Limit Exceeded PhoneID, Score, SMS, Voice
10020 Messaging exceeded transaction hard cap. Request denied. PhoneID, Score, SMS, Voice
10021 The product is not enabled for this country. SMS
10028 Required Authorization header is not in the correct format SMS
10030 Insufficient funds in prepaid wallet PhoneID, Score, SMS, Voice
10031 Not Allowed Host SMS
10032 Message blocked by TeleSign PhoneID, Score, SMS, Voice
10033 Unverified phone_number requested for trial account. PhoneID, Score, SMS, Voice
10034 Call with declared type blocked in country requested SMS, Voice
10035 The requested API host is not allowed for this customer_id SMS
10036 Reference ID expired SMS, Voice
11000 Invalid value for parameter phone_number PhoneID, Score, SMS, Voice
11001 Invalid country code for parameter phone_number PhoneID, Score, SMS, Voice
11002 Invalid value for parameter account_id
11003 Invalid value for parameter account_lifecycle_event PhoneID, Score, SMS, Voice
11004 Invalid value for parameter callback_url SMS, Voice
11005 Invalid value for parameter customer_id PhoneID, Score, SMS, Voice
11006 Invalid value for parameter device_id Score
11007 Invalid value for email_address Score
11009 Invalid value for parameter message SMS, Voice
11010 Invalid value for parameter originating_ip PhoneID, Score, SMS, Voice
11011 Invalid value for parameter reference_id PhoneID, Score, SMS, Voice
11017 Invalid value for parameter device_id SMS, Voice
12000 Missing required parameter phone_number PhoneID, Score, SMS, Voice
12003 Missing required parameter account_lifecycle_event Score
12009 Missing required parameter message SMS, Voice
12017 Missing required parameter message_type SMS, Voice