API Error Codes
When everything goes well, we'll send the response code 200 along with your data. If there is a problem, you will receive a response with error details formatted in JSON. Error responses will have one of the following HTTP status codes:
Error Code | Description | Notes |
---|---|---|
400 | Bad Request | When there was a problem with the request |
401 | Unauthorized | When an invalid key was provided |
403 | Forbidden | When access to the resource is not allowed |
429 | Too Many Requests | When the requestor exceeds the allowed request rate limit |
500 | Internal Server Error | An error internal to the API |
The 400 Bad Request response is a catch-all, sent if you have incorrect or missing parameters, exceed your API limits or request an unsupported format. The response body will have more detail. When an error occurs its corresponding status line appears in the status field of the error response object rather than in the response header. For example:
{
"userMessage": "Something went wrong",
"developerMessage": "Resource \"WorkflowTransition\" was not found"
}