Want to provide feedback?
Write to docs@telesign.com.
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 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. 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, Voice Verify |
| 104 | Wrong/invalid phone | The phone number is not correctly formatted in some way, so a call cannot be placed. Make sure phone numbers are complete, include the country code, and have no special characters or spaces. | 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 | This 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. | |
| 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 |
| 234 | Price threshold exceeded | Message not sent due to the price exceeding your set maximum price. | |
| 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 / MO successfully sent but 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. 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 |
| 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 call, SMS, or PhoneID 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 process attempted. | Smart Verify |
| 2028 | Failure | Blocked - the risk score after running a Score check on the number is 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 | The 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 API |
| 2429 | Call blocked by customer request | You can request that numbers be blocked. | App Verify API |
| 2430 | Call blocked by TeleSign | TeleSign blocks calls from numbers if the number is deemed suspicious. | App Verify API |
| 2800 | Request successfully completed | All PhoneID add-ons | |
| 2801 | Invalid request addons parameter: {parameter_name} | All PhoneID add-ons | |
| 2802 | name of add-on add-on temporarily unavailable. |
All PhoneID add-ons | |
| 2803 | Phone number out of name of add-on add-on coverage. |
All PhoneID add-ons | |
| 2804 | Phone number not applicable in name of add-on add-on. |
All PhoneID add-ons | |
| 2805 | No name of add-on add-on information for phone number. |
All PhoneID add-ons | |
| 2806 | Name of add-on add-on is not enabled. |
All PhoneID add-ons | |
| 2807 | Some parameters submitted in the request are not valid. | All PhoneID add-ons | |
| 2808 | Invalid Request: {parameter_name} parameter is missing or empty. | All PhoneID add-ons | |
| 2809 | Billing Postal Code does not match contact_plus add-on information for phone number. |
Contact Plus add-on | |
| 2810 | Request process failed during data collection. | All PhoneID add-ons | |
| 2811 | Request processing time out. | All PhoneID add-ons | |
| 2812 | name of add-on exceeded transaction hard cap. Request denied. |
All PhoneID add-ons |
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 | This feature is not enabled for this Customer ID. | 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 |
| -30012 | X-TS-Nonce header value has been used recently | SMS Verify, Voice Verify, Number Deactivation, Smart Verify, Completion |
| -30013 | Invalid ReferenceID for Verify Completion | Completion, Get Status |
| -30014 | Invalid App Verify API finalize | App Verify API |
| -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 |
| -40022 | App Verify API not supported | 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 |
| -50059 | Status not available | |
| -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 IP Address | 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 |