/
Errors

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.


Related content

Authentication
Authentication
More like this
Identity Verification (IDV)
Identity Verification (IDV)
More like this
IDV API
IDV API
Read with this
Legal entities data
Legal entities data
More like this
Webhooks
Webhooks
Read with this
Customer onboarding (KYC) integration with UI
Customer onboarding (KYC) integration with UI
Read with this