Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Error Codes

All Programmable Voice Error Codes are five-digit integers. Below is the list of errors Programmable Voice is currently using. Note that we are still working on finalizing the list and it may change while in Beta.

General Errors

Code Description Explanation
31000 Generic error. A call error occurred that is not covered by a more specific error code. No further information available. Check the debugger for more info.
31003 Connection timeout. The server could not produce a response within a suitable amount of time.
31004 Initialization error in iOS SDK. The iOS SDK couldn't initialize user agent due to an internal error.
31005 Connection error. A connection error occurred during the call.
31006 Audio device error. Unable to start the audio device.

Malformed Requests

Code Description Explanation
21218 TwiML application not found. The server was not able to find the TwiML application associated with the App SID.
31100 Malformed request. The request could not be understood due to malformed syntax.
31106 Invalid data. The provided data to handleMessage(...)/handleNotification(...) API was not valid.
31107 No CallInvite with this CallSid. A cancel notification was received for a non existing CallInvite.

Authorization Errors

Code Description Explanation
20101 Invalid access token. The Access Token provided to the SDK is invalid. This may happen when the Access Token is structurally incorrect.
20102 Invalid Access Token header. The header of the Access Token provided to the SDK is invalid.
20103 Invalid Access Token issuer/subject. The issuer or subject of the Access Token provided is invalid.
20104 Access Token expired or expiration date invalid. The Access Token provided to the SDK has expired, the expiration time specified in the token was invalid, or the expiration time specified was too far in the future.
20105 Access Token not yet valid. The Access Token provided to the SDK is not yet valid.
20106 Invalid Access Token grants. The Access Token does not include voice grants.
20107 Invalid Access Token signature. The signature for the Access Token provided was invalid. Ensure the secret included in the Access Token is valid.
20151 The authorization with Token failed. The system could not perform the authorization for the given request.
20157 Expiration Time Exceeds Maximum Time Allowed. The expiration time provided in the Access Token exceeds the maximum duration allowed.
20403 403 Forbidden. The expiration time provided in the Access Token exceeds the maximum duration allowed.
31201 Authorization error. The server understood the request, but is refusing to fulfill it. This happens when a CallInvite is generated from invalid data.

Registration Errors

Code Description Explanation
31301 Registration or Unregistration failed. The registration request to Twilio failed with an exception. This can be caused by an http related error or by an invalid push credential.
Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.