HTTP Status Codes

We use common HTTP status codes included in the response header to indicate success or failure.

Error Codes
200OK. Successful request.
201OK. Resource created.
400Bad request. Request message data did not pass validation.
401Unauthorised. Not authorised to access requested data.
403Forbidden. Access to requested data is forbidden.
404Not Found. Requested resource does not exist.
408Timeout. Operation timed out.
422Unprocessable entity. Request message data did not pass validation.
500Server error.

Validation Errors

Data validation or violation of business rules related errors. Response could contain multiple errors.

Validation Error Example
"errors": [
"code": "error.route.not.supported",
"message": "This route is not supported",
"arguments": [

Authentication Errors

Security related errors.

Authentication Error Example
"error": "unauthorized",
"error_description": "Full authentication is required to access this resource"

System Errors

Something went wrong in our side.

System Error Example
"timestamp": "2017-02-02T13:07:39.644+0000",
"status": 500,
"error": "Internal Server Error",
"exception": "java.lang.NullPointerException",
"message": "No message available",
"path": "/v1/quotes/0b63b0cb-2041-4bc4-b3fc-1e51a1454a1b/account-requirements"