Rate this page:

Voice SDK Error Codes

The majority of Programmable Voice error codes are five-digit integers starting at the 31000 range.

To get details on an error code, possible cause, and solutions, please visit the full Error and Warning Dictionary.

Note on JavaScript SDK Errors:

The JavaScript SDK, when applicable, will emit errors that contain a twilioError field. To view implementation information, visit the error handling sections of the Connection Reference Page's and the Device Reference Page.

This twilioError is the new TwilioError format that is now the default Error format in the new 2.0 version of the SDK. Please see the JavaScript SDK 2.0 Migration Guide for more information on this change.

Common Errors

310xx Series: General Errors

Code Description
31000 General Twilio Client error. More information may be available in the debugger. The twilioError field (JavaScript SDK only) may contain more information.
31001 TwiML Application not found.
31002 Connection declined. Check the debugger for more information on the actual cause.
31003 Connection timeout.
31005 WebSocket connection to Twilio's signaling servers were unexpectedly ended. If this is happening consistently, there may be an issue resolving the hostname provided. If a region is being specified in Device setup, ensure it's a valid region.
31009 No transport available to send or receive messages.

311xx Series: Malformed Requests

Code Description
31100 Generic malformed request.
31101 Missing parameter array in request.
31102 Authorization token missing in request.
31103 Length of parameters cannot exceed MAX_PARAM_LENGTH.
31104 Invalid bridge token.
31105 Invalid client name/identity. Note, the client/device name/identity provided in the AccessToken may only contain alpha-numeric and underscore characters. Other characters, including spaces, will result in undefined behavior. The maximum number of characters for the identity is 121.

312xx Series: Authorization Errors

Code Description
31201 Generic unknown error.
31202 JWT signature validation failed.
31203 No valid account.
31204 Invalid JWT token.
31205 JWT token expired.
31206 Rate exceeded authorized limit.
31207 JWT token expiration too long.
31208 User denied access to microphone.

53xxx Series: Signaling Errors

Code Description
53405 Media connection failed/Media activity ceased: The ICE connection failed
53000 Signaling connection error: The websocket timed out in preflight
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 by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

Loading Code Sample...

        Thank you for your feedback!

        Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!