DEVELOPER GUIDE
Codes and Errors
Open Finance Codes and Errors
5 min
api return code klavi apis use standard http error codes to communicate errors back to you in particular, our apis use standard http status 416 to express business processing errors here's a table of the possible error codes that you may encounter while using our apis code description notes 200, 201 successful request the request was successful 400, 422 bad request the request was malformed or missing required parameters 401 unauthorized the access token provided was invalid or has expired 403 forbidden the access token provided does not have sufficient permissions 404 not found the requested resource could not be found 409 conflict the request conflicts with an existing resource this error is usually related to idempotency key 416 business processing error some kind of business processing error occurred in the request the filed "statuscode" in the response payload specifically represents a kind of business process error please refer to the response instructions for each api 429 too many requests the api rate limit has been exceeded use exponential backoff for requests the transactions per second (tps) rate is adjusted based on the specific needs of each customer 500, 502, 503, 504 server errors something went wrong on our end if you receive this error, please contact our support team and provide the necessary information for us to investigate the issue business status code code description notes 4001 invalid authorisation info authorisation info has expired or does not exist 4002 invalid product info product info does not exist or the product level is not correct 4003 invalid consent request consents exceeds the limit 4004 invalid institution institution already out age or don't have permission 4005 invalid products products must not have fewer than 1 items 4006 invalid productscallbackurl invalid productscallbackurl 4007 product request failed product request failed 4008 insufficient authorization info no open finance consent available (for eco product only) 4009 insufficient authorization info kyc process needed for data inquiry (for eco product only) report status code the code plan in the product report is as follows 5000 to 5099 are common error codes 5100 to 5299 are planned as business error codes for each module code description 200 ok 204 bank side some apis not available 205 income info is null 5000 unexpected error 5001 task timeout 5002 consent expires 5003 bank side not available 5004 insufficient user authorization permissions 5100 account is null