Skip to main content

Aggregation status codes

The aggregation_status_code returned in the bank account object provides information on either:
  • The connection status of the individual bank account
  • An error the user encountered, and how to resolve
CodeDescriptionRequired Action
0SuccessNo issues encountered.
103Bad login credentialsHave the user enter new login credentials via a Connect URL.
108User prompt encounteredHave the user log in to their bank account and resolve the pop-up banner, typically by accepting new Terms and Conditions or acknowledging other account alerts.
109Credentials expired - new password requiredHave the user log in to their bank account and set a new password, then use a Connect URL to have the user enter the new login credentials.
169Duplicate accountHave the user keep one account and delete the duplicate(s) via a Connect URL.
185Security challenge encounteredUse a Connect URL to have the user answer the Multi-Factor Authentication (MFA) questions or enter the One-Time Passcode (OTP) sent by the financial institution.
187Incorrect security challenge answersUse a Connect URL to have the user answer the Multi-Factor Authentication (MFA) questions.
945OAuth migration (account migrated but not consented)Prompt the user to re-authenticate via a Connect URL. Otherwise, have the user delete the account and add it again under the same bank with the OAuth connection indicated by the financial institutions endpoint.
946Account not found (account may have been closed)Prompt the user to authenticate the right account via a Connect URL. Otherwise, have the user delete the account via a Connect URL and then find and add an active account.
947Token expired or refresh requiredA new token is needed; issue a new Connect URL for the user.
948OAuth migration (account migrated but not authenticated)Prompt the user to re-authenticate via a Connect URL. Otherwise, have the user delete the account and add it again under the same bank with the OAuth connection indicated by the financial institutions endpoint.
949Account unrecoverableHave the user delete the account and re-enter via a Connect URL to re-add the account.
147, 148, 173, 176, 181, 190, 900, 901, 903, 904, 906, 907, 940, 950Additional support requiredContact Argyle support.