By Bits APIs return error codes based on the type of error that has occurred. Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided. Codes in the 5xx range indicate an error with internal server errors.

An example error response:

{
  "message": "{\"source\":\"headers\",\"errors\":[{\"value\":\"\",\"path\":\"environment\",\"keyword\":\"enum\"}]}",
  "status_code": 422
}

Error Codes

Code Message
2XX OK - Success
401 UnAuthorised - No valid token, client id or client secret provided
403 Forbidden - The authenticated user isn't scoped for data
404 Forbidden - Not Found - The requested resource doesn't exist
429 Too many requests hit the API too quickly
5XX Internal server error