HTTP Status Codes

2xx

HTTP Status Code	Meaning Possible Reason(s)
200	OK Any method finished successfully
201	Created POST method on an entity inserted new data successfully

3xx

HTTP Status Code	Meaning Possible Reason(s)
304	Not Modified ETag: GET method with "If-None-Match" header if an entity has not been changed

4xx

HTTP Status Code	Meaning Possible Reason(s)
400	Bad request Invalid body, query parameter or path parameter An entity in the request body failed a validation
401 [1]	Authentication error Missing or invalid "Authorization" header
403 [1]	Authorization error Invalid or expired access token (JWT) Insufficient permissions
404	Invalid or non-existent resource ID GET method did not find any entity matching the filter
405	Method Not Allowed
409	Conflict PUT or PATCH method on an entity if the "versionDate" verification fails
412	Precondition Failed ETag: PUT or PATCH method with "If-Match" header if an entity has been changed
428	Precondition Required ETag: PUT or PATCH method on an entity called without the "If-Match" header
429	Too Many Requests

[1] The error response for status codes 401 and 403 has an extra field reason so as to further differentiate the situations programmatically. The value is an enumeration and can be one of these:

"reason"	"status"	Meaning / more detailed reason
INVALID_AUTH_HEADER	401	The Authorization header is missing or has an invalid value.
INVALID_REFRESH_TOKEN	401	The refresh token is invalid (not found).
BAD_REGISTRATION	401	Internal error - call the support.
UNAUTHORIZED	401	Not authorized with no specific reason given.
AUTHENTICATION_FAILED	401	Generic authentication error - call the support.
INVALID_ACCESS_TOKEN	403	The access token cannot be parsed or the signature verification failed.
ACCESS_TOKEN_EXPIRED	403	The access token has expired. Sign in again.
CLOUD_FORBIDDEN	403	The access to the given cloud is not allowed.
DOMAIN_FORBIDDEN	403	The access to the endpoint path is not allowed.
ACCESS_DENIED	403	The access is denied with no specific reason given.
AUTHORIZATION_FAILED	403	Generic authorization error - call the support.

5xx

HTTP Status Code	Meaning Possible Reason(s)
500	Internal Server Error Any method unexpectedly failed
501	Not Implemented Feature has not been implemented yet.