Voice Calling API Troubleshooting

MessageBird offers multiple tools to enable you to quickly understand any unexpected behavior between the MessageBird Voice Calling API and your application.

Explore the call logs in the Dashboard

If you run into issues with your voice calls, the best place to start troubleshooting is the Voice Call Logs in the MessageBird Dashboard.

Call Logs

Here you can find an overview of any issues detected with your voice calls.

You can also head to the Voice Calls section to view all voice calls for the last 30 days.

Voice error codes

If you've received an error response and code from MessageBird, you can troubleshoot the error by exploring the Voice Error Codes.

MessageBird uses standard HTTP status codes to indicate success or failure of an API request. Codes in the 2xx range indicate that a request was successfully processed and codes in the 4xx range indicate that there was an error that resulted from the information sent (e.g., authentication, no balance or a missing or wrong parameter).

In case of an error, the body of the response includes a json formatted response that tells you exactly what's wrong.

Error codes

codedescription
11A required parameter is missing in the request.
12A parameter has an invalid value.
13The requested resource could not be found.
14Access to the requested resource was forbidden.
15Authentication is missing from the HTTP request.
16The request body could not be parsed. Check if the body contents correspond with the supplied Content-Type HTTP header.
17Context of X-MessageBird-Version header is invalid.
18A query parameter has an invalid value.
21An internal server error on the MessageBird platform occured.
25A requested action on the object can't be processed.

HTTP status codes

HTTP status codedescription
200 FoundThe requested resource was found.
201 CreatedA resource has been created.
204 No ContentThe requested resource is empty.
400 Bad RequestThe request contains invalid/missing data, or is malformed.
401 UnauthorizedThe access key is missing or incorrect.
403 ForbiddenAccess to the requested resource was forbidden.
404 Not FoundThe resource could not be found.
405 Method Not AllowedThe HTTP method is not allowed.
500 Internal Server ErrorSomething went wrong on our end, please try again.

General error codes

If you've received an error response and code from MessageBird that is not listed in the above Voice API Codes list, you can troubleshoot the error by exploring the general API Error Codes.

In case of an API error, the body of the response includes a json formatted response that tells you exactly what's wrong.

Contact technical support

If you’re still having problems troubleshooting the Voice Calling API, please don’t hesitate to contact us at support@messagebird.com; we're here to help you out.

Questions?

We’re always happy to help with code or other doubts you might have! Check out our Quickstarts, API Reference, Tutorials, SDKs, or contact our Support team.

Cookie Settings