DEVELOPER GUIDE
Codes and Errors
Open Data Codes and Errors
2 min
the following code definition is only valid for open data common code code message description suggested instructions 200 ok 201 the crawler has completed the scheduled work, but some data still needs user's extra authorization, which is beyond klavi's control extra authorization required 202 the crawler has completed the scheduled work, but some transaction details failed to be downloaded it is related to the availability of data source itself, which is beyond klavi's control partial transaction missing 203 cpf missing the report did not return cpf value 400 signature failed signature failed 401 user not found \[get method only] no matching cpf found for data retrieve 402 user credential error generic error when the user input the wrong credential (e g e mail, phone number, account, password or token) and connection fails instruct users to double check their info and try it again 403 bank service error bank service is not available and connection failed instruct users to log in again later 404 unexpected error other unexpected error and connection failed open a ticket with the klavi team 405 account info is null connection is successful but no account information found 406 wrong password input too many times, try again tomorrow the user input the wrong credential too many times to avoid password blocking, the system has frozen the login retry until the next day instruct users to login after 1 day (24h) 407 account or password activation problem inactive account, inactive password, temporary password or expired password instruct users to resolve the pending issue with the bank 408 account or password blocked the account or password is blocked instruct users to reset their internet banking password 409 account type error the user input the credential of wrong account type (e g corporate or whitelabel credit card) instruct users to connect to a compatible account 410 input format error user input credential format is incorrect or missing 411 traceid is null or not found traceid of task is null or not found 412 token is not required token is not required 413 duplicated login duplicated login, users need to logout their bank and try again instruct users to close the current active sessions 414 security measurement from bank security measurement from bank that caused connection failure instruct users to connect after 1 day (24h) 415 institution registration not finished as a security measure, wait 30 minutes for the registration to be finished instruct users to log in after 30 min 416 account cannot be accessed in multiple devices unable to make the connection this account does not allow access on multiple devices 417 unable to connect using external authenticator unable to connect using an external authenticator, such as google, apple or facebook 418 registration not found at the institution registration not found at the institution trough the data provided 419 registration limit the amount of cell phones registration reached the limit for this cpf specific for fgts instruct the user to go to a caixa's agency 420 access regularization required user needs to regularize access specific for fgts instruct the user to go to a caixa's agency 429 too many requests too many api requests in a short period 430 the data has been deleted the data has been deleted by calling the delete api 431 connection update limit exceeded number of updates requested are above the limit allowed 432 institution unavailable a connection request was made to an institution that is currently unavailable check our status page for more updates on institution availability (https //status klavi ai/) 433 password error the user input wrong password instruct users to input the correct password 434 wrong mfa error the user inputs the wrong mfa token instruct users to input the correct mfa token 435 mfa not entered the user doesn't input the mfa token instruct users to input the correct mfa token 500 internal server error internal server error 501 invalid access \[get method only] either partner code or partner token is missing 502 partner code not activated \[get method only] partner code has not been activated or is disabled 503 partner credential error \[get method only] wrong partner code or partner token 504 permission required for the data type \[get method only] permission required for the data type 505 request parameter missing or invalid \[get method only] request parameter missing or invalid update user data code code message description 200 ok 600 invalid route invalid route for access 601 auto update unauthorized auto update is not authorized by user 602 request body invalid parameter in request body is missing or invalid (e g connectionkey or allowautoupdate) 701 invalid access either partner code or partner token is missing 702 partner code not activated partner code has not been activated or is disabled 703 partner code or token invalid wrong partner code or partner token 704 no access permission partners have no access permission to this service 708 data format verification failed the request data format is incorrect