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.
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
| code | description |
|---|---|
| 11 | A required parameter is missing in the request. |
| 12 | A parameter has an invalid value. |
| 13 | The requested resource could not be found. |
| 14 | Access to the requested resource was forbidden. |
| 15 | Authentication is missing from the HTTP request. |
| 16 | The request body could not be parsed. Check if the body contents correspond with the supplied Content-Type HTTP header. |
| 17 | Context of X-MessageBird-Version header is invalid. |
| 18 | A query parameter has an invalid value. |
| 21 | An internal server error on the MessageBird platform occured. |
| 25 | A requested action on the object can't be processed. |
HTTP status codes
| HTTP status code | description |
|---|---|
| 200 Found | The requested resource was found. |
| 201 Created | A resource has been created. |
| 204 No Content | The requested resource is empty. |
| 400 Bad Request | The request contains invalid/missing data, or is malformed. |
| 401 Unauthorized | The access key is missing or incorrect. |
| 403 Forbidden | Access to the requested resource was forbidden. |
| 404 Not Found | The resource could not be found. |
| 405 Method Not Allowed | The HTTP method is not allowed. |
| 500 Internal Server Error | Something 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.
