Aggregation Status Codes
The following is a list of aggregation status codes that can be returned from the API. Aggregation status codes are in relation to the result of what happened when Finicity attempted to connect to the financial institution.
Aggregation status codes that happen during API calls will come back consistently as HTTP 500 response and in the body of the response you will get the specific aggregation status code.
These codes will appear in the field aggregationStatusCode of a Customer Account API for accounts added in the system. An aggregation status code of “0” means the account is aggregating successfully.
User Action Aggregation Status Codes
Some status codes that occur during aggregation are actionable by the end user. In these scenarios the end user must take action in order for aggregation to work properly. A list of these status codes and the associated description listed below.
User Action Aggregation Status Codes
| Code | Connect Message | Error Description |
|---|---|---|
| 103 | The login credentials you entered are not valid for this account. Please log into your bank’s site and make sure you have access and then try again. Error code 103 | During add account process this means that the customer has entered the wrong credentials On an already added account means that the credentials have changed and need to be updated. |
| 108 | User action is required at your financial institution. Log into your financial institution and check if you have any actions that need to be taken. Error code 108 | During add account process this means there is a prompt from the financial institution that the customer must solve before they attempt to add accounts again. On an already added account means the same, that there is a prompt that the customer must solve it just happened after account where initially added. A common example would be customer has to accept new terms or has been invited to participate in a program like e-statements) |
| 109 | Your financial institution is requiring new security info. Try logging into your financial institution and changing or updating your security credentials. Error code 109 | During add account process this means the customer must change their username/password or update their security at the FI page. On an already added account means the customer must change their username/password or update their security at the FI page it just happened after initially adding accounts. This typically means that the customer institution is requiring that they change their security information like password or security questions |
| 185 | During the nightly batch aggregation or during a non-interactive refresh MFA was needed. | You will not see this error on the add account process. On an already added account means that the FI is prompting the customer for additional authentication information. There may not be an answer or an incorrect answer stored for the security question. |
| 187 | The answer to your security question was incorrect. Please add your account again. Error code 187 | During add account process this means that the customer has entered the wrong MFA answer. This error only happens during the add account process |
| 913 | (not applicable) | The account has been closed at the financial institution so we can no longer pull data. The application should have some way to handle closed accounts by removal or by changing it to some type of offline account. |
| 914 | (not applicable) | The account can no longer be located at the financial institution under the current set of credentials. Customer should log into their banks website and see if the account is available through their online banking portal. If it is submit a support ticket.The application should have some way to remove the account or change it to some type of offline account. |
| 931 | (not applicable) | The bank requires a one time passcode every time the customer wants their financial information refreshed. Inform the customer of this situation and facilitate them authenticating every time they use the app to enter the one time passcode so they can get the latest financial info. |
| 936 | You have a language preference other than English at your financial institution, which is not supported. Please log in to your financial institution and change your language to English in order to connect. Error code 936 | The customer has a language preference other than English. This could potentially cause issues with the integration for this specific institution. Have the customer change their language preferences to English for their accounts in order to get the best experience. |
Institution Outage or Maintenance Aggregation Status Codes
To keep our Clients and end users informed about financial institution outages or maintenance, we have created the following list of status codes along with descriptions. We may add more status codes to this list over time as we find additional scenarios where more specific information would be helpful.
Institution Outage or Maintenance Aggregation Status Codes
| Code | Connect Message | Error Description |
|---|---|---|
| 102
320 580 | Problem connecting. Please wait a few minutes and try again. | Temporary Issue At The FI. Wait and try again. Submit a ticket if the issue persists. |
| 900 | We are currently working to add support for this Financial Institution Connection. Your attempts to connect help us to do this. Please make several attempts to sign in if possible as multiple attempts will assist further. Then wait and try again in a week when we have made further progress | This is a new institution connection being created. The customers attempt to add will help move the process along in creating the new connection. The customer can try again in a week to see if support has been added. |
| 901 | We are currently working to add support for this Financial Institution Connection. Your attempts to connect help us to do this. Please make several attempts to sign in if possible as multiple attempts will assist further. Then wait and try again in a week when we have made further progress. | This is a new institution connection being created. The customers attempt to add will help move the process along in creating the new connection. If the customer can attempt multiple times to log in that will assist the process further. The customer can try again in a week to see if support has been added. |
| 903 | We are currently working to add support for this Financial Institution Connection. Your attempts to connect help us to do this. Please make several attempts to sign in if possible as multiple attempts will assist further. Then wait and try again in a week when we have made further progress. | This is a new institution connection being created. The customers attempt to add will help move the process along in creating the new connection. If the customer can attempt multiple times to log in that will assist the process further. The customer can try again in a week to see if support has been added. |
| 904 | We are currently working to add support for this Financial Institution Connection. Your attempts to connect help us to do this. Please make several attempts to sign in if possible as multiple attempts will assist further. Then wait and try again in a week when we have made further progress. | This is a new institution connection being created. The customers attempt to add will help move the process along in creating the new connection. If the customer can attempt multiple times to log in that will assist the process further. The customer can try again in a week to see if support has been added. |
| 905 | We are currently working to add support for this Financial Institution Connection. Your attempts to connect help us to do this. Please make several attempts to sign in if possible as multiple attempts will assist further. Then wait and try again in a week when we have made further progress. | The connection to this financial institution is being fixed. If the customer can make multiple attempts to add it will assist in the fix process. |
| 906 | We are currently working to add support for this Financial Institution Connection. Your attempts to connect help us to do this. Please make several attempts to sign in if possible as multiple attempts will assist further. Then wait and try again in a week when we have made further progress. | The connection to this financial institution is being fixed. If the customer can make multiple attempts to add it will assist in the fix process. |
| 907 | We are currently working to add support for this Financial Institution Connection. Your attempts to connect help us to do this. Please make several attempts to sign in if possible as multiple attempts will assist further. Then wait and try again in a week when we have made further progress. | The connection to this financial institution is being fixed. If the customer can make multiple attempts to add it will assist in the fix process. |
| 910 | Problem connecting to your institution. The problem is being worked on, so please try back in 3 to 5 days | The connection is currently down and being worked on. |
| 915 | We are currently working to fix this connection. Your attempts to connect assist in that effort. Please make several attempts to sign in if possible as multiple attempts will assist further. Then you may wait and try again in a week when we have made further progress. | The connection to this financial institution is being fixed. If the customer can make multiple attempts to add it will assist in the fix process. |
| 916 | We are currently working to fix this connection. Your attempts to connect assist in that effort. Please make several attempts to sign in if possible as multiple attempts will assist further. Then you may wait and try again in a week when we have made further progress. | The connection to this financial institution is being fixed. If the customer can make multiple attempts to add it will assist in the fix process. |
| 920
to 929 | Your financial institution is currently not supported. Inform your institution they should contact institutions@finicity.com to resolve the issue. | There could be multiple reasons that an institution does not support aggregation. We recommend the customer reach out to their financial institution and tell them to contact Finicity by emailing institutions@finicity.com in order to resolve the issue and become a supported institution. |
Other HTTP Codes
See this REST API Tutorial page for an explanation of other HTTP codes, such as HTTP 204, 400, 404, or 429.