Error Codes

API Error codes

The following table lists possible error codes that you may receive when calling our API.

HTTP Status CodeFlinks CodeDescriptionMessageSteps to Reproduce
200N/AThe connection was successful.Complete a successful request.
202OPERATION_PENDINGThe process is ongoing in the background. At this point your flow must change to the async endpointYour operation is still processing.Perform a cached flow immediately after Authorizing a new account
202OPERATION_DISPATCHEDYour sync request took more than 210 seconds and it was dispatched in the background.Your operations had been dispatched to background process for long running jobsHave a live request to gather GetAccountDetails in more than 210 seconds
400SESSION_NONEXISTENTA request was made with an expired RequestIdInputs session id or card if were not found.Use an old RequestId for a new request
400CARD_IN_USEAn operation was requested while the account is still being processed.Call the DeleteCard endpoint immediately after Authorizing a new account
401INVALID_LOGINThe provided LoginId is invalidThe LoginId provided is either invalid or does not belong to the CustomerIdCall the Authorize endpoint using a non existent LoginId
401INVALID_LOGINThe provided username or/and password is/are invalidThe card number (username) or password provided is invalidCall the Authorize endpoint using non valid credentials
401INVALID_REQUESTCredentials are missing/incomplete, or syntax is incorrect (e.g. missing comma)Message returned will depend on the error (e.g. missing value, incorrect syntax, etc.)In input, make a typo, remove a comma, etc.
401INVALID_USERNAMEThe username provided was different from what the bank expectedProvide an invalid username to an Authorize request
401INVALID_PASSWORDThe password provided was different from what the bank expectedProvide an invalid password to an Authorize request
401INVALID_SECURITY_RESPONSEThe MFA response provided was different from what the bank expectedProvide an invalid MFA answer to an Authorize request
401QUESTION_NOT_FOUNDThe MFA prompt doesn't have a stored answer
401RETRY_LATERFlinks was not able to open a connection with the selected financial institutionFlinks Capital Username: test_service_unavailable Password: Everyday
401UNKNOWN_CHALLENGE_KEYThe /Authorize request to respond an MFA contain an answer to the wrong MFA prompt."One or more of the Security Challenge Prompts required are missing in the provided response"Change the MFA prompted, or leave the MFA prompt blank in the input Change the MFA response or leave the MFA response blank
401CONCURRENT_SESSIONAnother session is already opened with this LoginIdOpen two requests simultaneously with the same account
401UNAUTHORIZEDThe card was not authorized. Either there is a problem with bank, or the GetAccountsDetail endpoint was called before authorizedYou need to be authorized in the bank account before going further.Call the GetAccountsDetail endpoint during an MFA prompt without answering the MFA question
401DISABLED_LOGINThe account has been deactivated by the financial institution. The account holder must contact their bankLog into a deactivated account
401NEW_ACCOUNTThe end user must take action directly on their online banking before connecting an account with FlinksLogin to an account where the user must take action on the bank's website (e.g. to accept a consent form)
401SESSION_EXPIREDThe RequestId expired after 8 mins of inactivity during Authorize or 30 mins timeout for data processingWait at least 8 minutes before responding to MFA
401ALREADY_AUTHORIZEDWhen the /Authorize endpoint is called after the user has already been authorizedAnswer an MFA for an already authorized requestid
401SECURITYRESPONSES_INCOMPLETENot all the prompted MFA questions had answers in the reponse requestNot answer all MFA questions prompted in 3 question MFA prompt
404NO_TRANSACTIONThe account does not have any transactionsNo transactions were found.Perform an Attributes request for an account with no GetAccountDetails previously processed
405DISABLED_INSTITUTIONThe selected financial institution is not available
500AGGREGATION_ERRORFlinks had an unexpected error and could not process your request
501METHOD_NOT_AVAILABLEThe requested API is not currently enabled in your instance. Kindly contact us if you wish to use this feature.

Warnings in Client Dashboard

The following table lists all possible errors that you may receive when using Client Dashboard.

HTTP Status CodeErrorMessage in Client Dashboard
203Answering Security ChallengeThe user is answering the security questions.
200Partially CompletedAccount summary was completed. We are still processing the account details.
401Session ExpiredThe user's session expired.
200CompletedThe request was completed successfully.
401Invalid PasswordThe request was completed successfully.
401Invalid UsernameThe user entered an invalid username.
N/ANot CompletedThe request was not completed.
401Invalid LoginThe credentials the user provided were incorrect.
401New AccountThe user needs to perform an action on the online banking site and try again later.
401Disabled LoginThe user account is locked out. The user needs to reset his password directly on the online banking website.
401Retry LaterAfter several attempts, we were unable to log into the user account. The user needs to try again later.
401Invalid Security ResponseThe security answer(s) the user entered are invalid.
401Unknown Challenge KeyOne or more of the Security Challenge Prompts required are missing in the provided response.
401UnauthorizedThe institution did not authorize the access of the summary page.
202Operation PendingThe operation is still processing.
202Operation DispatchedThe operation has been dispatched and will be processed soon.
200Get Statements CompleteWe successfully fetched the PDF statements.
200Scoring Insight CompletedWe successfully generated the score.
400Session NonexistentThe session does not exist.
401Concurrent SessionTwo or more sessions were triggered at the same time.
200Get Details Complete Statements Still ProcessingAccount details was completed. We are still processing the statements.
401Bank Maintenance Retry LaterThe institution was under maintenance. The user needs to try again later.
200Ocr Files UploadedFiles was uploaded successfully. We are processing the statements.
200Ocr Integration StartedFiles was uploaded successfully. We are processing the statements.
N/AOcr Files Integration FailureOne or more files uploaded are rejected or not supported. Click on the request for more details.
N/AOcr Completed With Partial ErrorOne or more files uploaded are rejected or not supported. Click on the request for more details.