Errors

The Didomi API uses standard HTTP response codes to indicate that an API request is a success or a failure. In general, the codes act as follows:
  • 2xx codes indicate a success
  • 4xx codes indicate an error in the parameters sent to the server (e.g., the authentication information is invalid, a required parameter is missing, etc.)
  • 5xx codes indicate a Didomi server-side error (it should not happen, but hey, we are human too!)
When an error happens, you can look at the JSON response body to find more about the reason. The body will be an object with the following properties:
Property
Description
Example
code
The HTTP response code
400
name
The name of the error (tied to the response code)
BadRequest
message
An explanation of the error
Invalid authentication information
errors
An array containing more errors if multiple errors have been batched together
Example:
{
"code": 400,
"errors": {},
"message": "Invalid authentication information",
"name": "BadRequest"
}