Errors

4xx HTTP status codes means you made a mistake and you need to adjust your request.

400 - Bad Request

API usage error. This means you did something wrong and there should be a message in the body that explains it. Error message is related to specified resource. Fix it and try again.

401 - Unauthenticated

Authentication error. Response body will give explanation if there is authorisation issue or if the API is not enabled.

403 - Permissions Denied

Authorization error. If you are authenticated but lack permissions.

404 - Not Found

Obviously incorrect paths (/cats) returns 404.

429 - Too Many Requests

You can perform up to 100 requests per 60 second period from the same IP address. If you exceed this limit, you'll get a 429 Too Many Requests response for subsequent requests. Check the Retry-After HTTP-header to see how many seconds to wait before retrying the request.

500 - Server error

System errors (aka we screwed up) returns 5xx HTTP status codes without any detailed information. We log all system errors, but please contact us if you get this response.

New! Customer data validation Error codes

"CB_5000": "Invalid user name"

"CB_5001": "First name contains invalid special characters"

"CB_5002": "Last name contains invalid special characters"

"CB_5003": "Phone number can only contain the digits 0-9"

"CB_5004": "Invalid country code"

"CB_5005": "Invalid country calling code"

"CB_5006": "Invalid email address"

"CB_5007": "Date of birth must be in the past"

"CB_5008": "First name is empty"

"CB_5009": "Last name is empty"

"CB_5010": "First name must not be longer than 255 characters"

"CB_5011": "Last name must not be longer than 255 characters"

"CB_5012": "Phone number must be between 1 and 255 characters long"

"CB_5013": "Country code must be between 1 and 255 characters long"

"CB_5014": "Phone number with calling code must be between 1 and 255 characters long"

"CB_5015": "Email address must be between 1 and 255 characters long"

"CB_5016": "Email address is empty"