As a RESTful API, Twilio's Verify API will return HTTP responses and error codes which will help verify normal behavior as well as contextualize exceptions.
The following status codes are used:
Response is correct. The body of the response will include the data requested.
400: Bad Request
There was an error with the request. The body of the response will have more info.
Token is invalid. If your API key is wrong a 401 will be generated. Please check the API key.
429: Too Many Requests
API usage limit. If you reach API usage limits, a 429 will be returned. Please wait until you pass the limit and attempt the call again.
503: Service Unavailable
There are multiple possible reasons for a
HTTP 503 error.
- Internal Twilio error.
- Your application is accessing an API call you don't have access to.
When the API returns a status other than
200, we add an error code in the message body. This table enumerates and describes all of the possible error codes.
|Error Code||HTTP Status||Error Message||Description||Category|
|60000||400||An error occurred||Default error message when an error is not configured correctly.||ALL|
|60001||401||Invalid API key||When the given API key does not correspond to any Authy app||ALL|
|60002||400||Invalid request||A request containing invalid parameters or invalid data||ALL|
|60003||429||DoS protection||Client has reached the maximum number of requests per time unit on the given endpoint||ALL|
|60004||400||Invalid parameter||The given parameter is not valid||ALL|
|60005||400||UTF-8 invalid||Client sending request with UTF-8 invalid characters||ALL|
|60021||403||Phone verification couldn't be created||An error occurring creating phone verification||Phone Verification|
|60022||401||Verification code is incorrect||The phone verification code was incorrect||Phone Verification|
|60023||404||Phone verification not found||The phone verification was not found with the parameters given||Phone Verification|
|60032||400||SMS was not found||Used by the Feedback API, when a record cannot be found with the given SMS id||Feedback|
|60033||400||Phone number is invalid||The phone number or country code is invalid||ALL|
|60042||400||Either uuid or country_code and phone number are required||Invalid parameters in phone verification||Phone Verification|
|60046||400||Missing dashboard account ids to process||accounts ids required to be processed||Dashboard|
|60060||503||Your account is suspended||Twilio account is suspended||Phone Verification|
|60064||403||Failed to enable OneTouch||Can't update application settings on enabling onetouch||Dashboard|
|60065||403||Needs to enable OneTouch first||Application does not have onetouch enabled and is trying to do a onetouch request||Dashboard|
|60066||403||Error saving the callback information||When application settings can't be updated with callback information||Dashboard|
|60069||400||Access key can not be saved||Access key invalid on creation||Dashboard|
|60070||400||Application was not valid||Application was not valid on create or update||Dashboard|
|60071||404||Access key not found||Access key not found||Dashboard|
|60072||404||Invalid access key||The access key is wrong||Dashboard|
|60073||400||Invalid application API key||Application API Key is wrong||Dashboard|
|60074||400||Access key doesn't have enough permissions||The given access key doesn't have enough permissions to access the url||Dashboard|
|60075||400||Delete application failed||Can not delete application due some special condition. i.e still has users when tried to delete the app or has pending invoices||Dashboard|
|60078||403||Invalid country code||The given country code is not valid||ALL|
|60082||403||Can not send SMS to landline phone numbers||When trying to send a SMS to a landline phone number||Phone Verification|
|60083||403||Phone number not provisioned with any carrier||When trying to send a phone verification to a not provisioned phone number||Phone Verification|