Rate this page:

Programmable Voice Client: Error Codes

You’re viewing the 1.X version of the Voice JavaScript SDK (formerly called Twilio Client). Click here for information on how to migrate to the 2.X version.

This page lists the errors that Twilio Client may emit. The error codes are five-digit integers beginning with 31.

For a full list of error codes that may be encountered, see the Error and Warning Dictionary

Twilio Errors

When applicable, errors emitted will contain a twilioError field, providing more information about the error. This twilioError represents the new TwilioError format that will become the default Error format in the next major release. Please see Connection and Device .on('error', handler(error))API for more information.

310xx Series: General Errors

Code Description
31000 General Twilio Client error. The new twilioError field may contain more information and more information may be available in the debugger.
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 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.
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.


        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!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more