Error Handling

Client Side Errors

TypeReasonStatus codeCode
Unauthorised/UnauthenticatedUsername & password in not correct(in Auth API)401missing_parameters_in_headers
Unauthorised/UnauthenticatedPublic token is invalid401invalid_parameters_in_headers
Unauthorised/UnauthenticatedPublic token is missing401missing_parameters_in_headers
Unauthorised/UnauthenticatedPublic token is expire401expired_parameters_in_headers
Unauthorised/UnauthenticatedUser access token is invalid401invalid_parameters_in_headers
Unauthorised/UnauthenticatedUser access token is missing401missing_parameters_in_headers
Unauthorised/UnauthenticatedUser access token is expire401expired_parameters_in_headers
Unauthorised/UnauthenticatedUnauthorised access to transaction401unauthorized_access
ForbiddenUser access token is not mapped with Public access token(Client)403client_not_authorized
Bad Request(Parameters is missing or Invalid)Parameter is missing in request(Either one or more parameters)400missing_parameters_in_request
Bad Request(Parameters is missing or Invalid)Parameters are not incorrect(If value is not correct)400wrong_parameters_in_request
Bad Request(Parameters is missing or Invalid)Parameters are not incorrect (If value is not valid)400invalid_parameters_in_request
Bad Request(Parameters is missing or Invalid)Parameters are not in correct format400incorrect_format_of_parameters_in_request
Bad Request(Parameters is missing or Invalid)Parameter are not in correct type(Wrong type of parameters) in request400incorrect_type_of_parameters_in_request
Bad Request(Parameters is missing or Invalid)Callback is not available400missing_callback_url
Bad Request(Parameters is missing or Invalid)Parameters is expired400expired_parameters_in_request
Unprocessable requestDormant user422inactive_user
Unprocessable requestConcurrent user/ Session is available is other device400session_available_in_other_device
Resource not availableNot authorised to complete the request404feature_not_available
Source is not authorisedRequest is not from whitelisted IP401ip_not_whitelisted
Rate limit exceededMore number of request than rate limit401rate_limit_exceeded
Method not allowedWrong method405method_not_allowed

Server Side Errors

TypeReasonStatus CodeCode
Service unavailableService unavailable (Brick)500service_unavailable
Service unavailableService unavailable (Institution level)500institution_not_available
Unexpected behaviourData can not retrieved500unexpected_behaviour
Unexpected behaviourInternal crash500unexpected_behaviour
Server unavailableServer unavailable500server_unavailable