Errors

Ondato APIs use conventional HTTP response codes to indicate if the request was a success or a failure. These responses are unified; therefore, the format of the response will always be the same across all APIs.


HTTP status code summary

Code

Description

Description

Example value

Code

Description

Description

Example value

400

Bad Request

The request was unacceptable, which indicates that the given request parameters are invalid or missing required parameters.

"reason": "ValidationFailed", "message": "The request is invalid.", "params": { "additionalProp1": [ { "reason": "Required", "message": "Property should not be empty." } ] }

401

Unauthorised

No valid access token provided.

"reason": "AuthenticationFailed", "message": "The access token is missing, invalid, or is revoked."

403

Forbidden

The access token doesn't have permissions to perform the request.

"reason": "AuthorizationFailed", "message": "The subject of the token does not have the permissions that are required to access the resource."

404

Not Found

The requested resource does not exist.