HTTP Status Codes

The page contains the list of HTTP response status codes that Dialpad public APIs return.

2xx: Success

Status CodeDescription
200 OKThe request was successful, and the payload accompanying the response varies based on the request method used. For instance, a GET request will include the requested entity in the response.

4xx: Bad Request

Status CodeDescription
400 Bad RequestThe request could not be processed by the server due to malformed syntax, for example, missing required parameters. The client should refrain from resubmitting the request without modifications. The response will contain detailed error messages indicating issues with the request.
401 UnauthorizedAuthentication information is missing or invalid. See for details on authentication basics.
403 ForbiddenThe request contained valid authentication data and was understood by the server, but the server is refusing action. This may be due to the client not having the necessary permissions to access a resource or attempting a prohibited action.
404 Not FoundThe server has not found anything matching the request.
409 ConflictThe request could not be completed due to a conflict with the current state of the resource, for example, the resource already exists when a POST request is sent. The response will contain detailed error messages indicating the issues with the request.
413 Request Entity Too LargeThe server is refusing to process a request because the request entity is larger than the what server is willing or able to process, for example, the attachment size exceeded allowed limit in the SMS API.
429 Too Many RequestsThe client has sent too many requests in a given amount of time. See for an overview and the API reference of each endpoint for details.

5xx: Server Errors

Status CodeDescription
503 Service UnavailableThe server cannot handle the request due to an internal server error or service is overloaded. If you receive "Cannot generate response. Please contact support with error UUID: xxxx" in the response, please reach out to our support for help.