# Account Errors source: https://developer.mastercard.com/open-finance-us/documentation/errors/account-errors/index.md To aid you in understanding error context and more effectively troubleshoot problems, Mastercard Open Finance errors have been categorized into **themes**. This section covers account level errors. Account level errors occur during the following scenarios: * **First-time login** : When an end user logs into the partner's application and attempts to add or link their accounts for the first time, the [Mastercard Data Connect](https://developer.mastercard.com/open-finance-us/documentation/connect/generate-2-connect-url-apis/index.md) session enables several events such as financial institution discovery, account selection, account permissioning and authentication flow for the selected bank. Data Connect automatically displays alerts so the end user can take recommended actions and resolve errors that may occur during any of these events. * **Adding/linking another account** : When an end user returns to add or link another account, the [Data Connect](https://developer.mastercard.com/open-finance-us/documentation/connect/generate-2-connect-url-apis/index.md) alerts (error messages in the user interface) guide the end user to take recommended actions to complete all required events for a successful Data Connect session. * **Partner-initiated requests** : If an end user is not present on the partner's application and the partner-initiated data request returns an error, when the user returns to a live session, the [Data Connect](https://developer.mastercard.com/open-finance-us/documentation/connect/generate-2-connect-url-apis/index.md) alerts open and direct the user to take the recommended action and resolve errors where applicable. * **Scheduled data refresh** : Mastercard schedules data refreshes to ensure end users' transactional data is current. This updated data is accessible via our APIs or directly pushed to partners enrolled in [TXpush](https://developer.mastercard.com/open-finance-us/documentation/products/manage/tx-push/index.md). If a data refresh fails, Open Finance APIs return the appropriate error code, and where applicable, [Data Connect](https://developer.mastercard.com/open-finance-us/documentation/connect/generate-2-connect-url-apis/index.md) alerts appear when the end user returns to a Data Connect session. The user can then take recommended actions and resolve the errors. ## Aggregation Status Codes {#aggregation-status-codes} As accounts are aggregated during automated data refresh, an aggregation status code is returned via the `aggregationStatusCode` field in the [Account Aggregation](https://developer.mastercard.com/open-finance-us/documentation/products/manage/account-aggregation/index.md) endpoints. An `aggregationStatusCode` represents the status or outcome of an aggregation process. * An `aggregationStatusCode` of **0** denotes that a successful aggregation of the account(s) has occurred. ```JSON { "accounts": [ { "id": "6049480293", "number": "2000004444", "accountNumberDisplay": "4444", "name": "Roth IRA", "balance": 525.18, "type": "investment", "aggregationStatusCode": 0, "status": "active", "customerId": "6027530414", "institutionId": "101732", "balanceDate": 1685020689, "aggregationSuccessDate": 1685020728, "aggregationAttemptDate": 1685020728, "createdDate": 1685020611, "currency": "USD", "lastTransactionDate": 1685020689, "institutionLoginId": 6023453620, "detail": { "marginAllowed": true, "cashAccountAllowed": true, "vestedBalance": 1250.00, "currentLoanBalance": 4500.00, "loanRate": 3.00 }, "displayPosition": 3, "financialinstitutionAccountStatus": "OPEN", "accountNickname": "Roth IRA", "oldestTransactionDate": 1667736000, "marketSegment": "personal" }, { "id": "6049480311", "number": "1000002222", "realAccountNumberLast4": "2222", "accountNumberDisplay": "2222", "name": "Savings", "balance": 525.18, "type": "savings", "aggregationStatusCode": 0, "status": "active", "customerId": "6027530414", "institutionId": "101732", "balanceDate": 1685020689, "aggregationSuccessDate": 1685020737, "aggregationAttemptDate": 1685020737, "createdDate": 1685020619, "currency": "USD", "lastTransactionDate": 1685020689, "institutionLoginId": 6023453620, "detail": { "availableBalanceAmount": 525.18, "periodInterestRate": "4.5", "openDate": 1639206000 }, "displayPosition": 6, "financialinstitutionAccountStatus": "OPEN", "accountNickname": "Savings", "oldestTransactionDate": 1667736000, "marketSegment": "personal" }, { "id": "6049480317", "number": "1000001111", "realAccountNumberLast4": "1111", "accountNumberDisplay": "1111", "name": "Checking", "balance": 525.18, "type": "checking", "aggregationStatusCode": 0, "status": "active", "customerId": "6027530414", "institutionId": "101732", "balanceDate": 1685020689, "aggregationSuccessDate": 1685020740, "aggregationAttemptDate": 1685020740, "createdDate": 1685020621, "currency": "USD", "lastTransactionDate": 1685020689, "institutionLoginId": 6023453620, "detail": { "availableBalanceAmount": 525.18, "periodInterestRate": "4.5", "openDate": 1639206000 }, "displayPosition": 5, "financialinstitutionAccountStatus": "OPEN", "accountNickname": "Checking", "oldestTransactionDate": 1667736000, "marketSegment": "personal" } ] } ``` * Other `aggregationStatusCode` signifies an error state. ```JSON { "accounts": [ { "id": "6049960514", "number": "2000004444", "accountNumberDisplay": "4444", "name": "Roth IRA", "balance": 529.20, "type": "investment", "aggregationStatusCode": 185, "status": "active", "customerId": "6027787614", "institutionId": "101732", "balanceDate": 1685366419, "aggregationAttemptDate": 1685366452, "createdDate": 1685366419, "currency": "USD", "institutionLoginId": 6023673450, "detail": {}, "displayPosition": 3, "financialinstitutionAccountStatus": "OPEN", "accountNickname": "Roth IRA", "marketSegment": "personal" }, { "id": "6049960518", "number": "1000002222", "accountNumberDisplay": "2222", "name": "Savings", "balance": 529.20, "type": "savings", "aggregationStatusCode": 185, "status": "active", "customerId": "6027787614", "institutionId": "101732", "balanceDate": 1685366419, "aggregationAttemptDate": 1685366452, "createdDate": 1685366419, "currency": "USD", "institutionLoginId": 6023673450, "displayPosition": 6, "financialinstitutionAccountStatus": "OPEN", "accountNickname": "Savings", "marketSegment": "personal" }, { "id": "6049960519", "number": "1000001111", "accountNumberDisplay": "1111", "name": "Checking", "balance": 529.20, "type": "checking", "aggregationStatusCode": 185, "status": "active", "customerId": "6027787614", "institutionId": "101732", "balanceDate": 1685366419, "aggregationAttemptDate": 1685366452, "createdDate": 1685366419, "currency": "USD", "institutionLoginId": 6023673450, "displayPosition": 5, "financialinstitutionAccountStatus": "OPEN", "accountNickname": "Checking", "marketSegment": "personal" } ] } ``` The following table lists the different error states that may occur during the aggregation process. | Error Codes | Error Theme | Description | |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [909](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/account-not-found/909-913-914-946-952/index.md#909) ​​[913](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/account-not-found/909-913-914-946-952/index.md#913)​​ [914](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/account-not-found/909-913-914-946-952/index.md#914)​​ [946](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/account-not-found/909-913-914-946-952/index.md#946)​​ [952](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/account-not-found/909-913-914-946-952/index.md#952) [38003](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/account-not-found/909-913-914-946-952/index.md#38003) | Account Not Found | Bank account cannot be found at the financial institution. | | [185](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/incompleteauth/938-940-971-185-187/index.md#185) [187](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/incompleteauth/938-940-971-185-187/index.md#187) [931](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/incompleteauth/938-940-971-185-187/index.md#931) [938](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/incompleteauth/938-940-971-185-187/index.md#938) [940](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/incompleteauth/938-940-971-185-187/index.md#940) [12003](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/incompleteauth/938-940-971-185-187/index.md#12003) | ​​Incomplete Authorization ​ | Inadequate response to security questions from the end user. | | [106](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/addinfo/106-108-109-961-959/index.md#106) [108](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/addinfo/106-108-109-961-959/index.md#108) [109](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/addinfo/106-108-109-961-959/index.md#109) [936](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/addinfo/106-108-109-961-959/index.md#936)​​ [959](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/addinfo/106-108-109-961-959/index.md#959) [961](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/addinfo/106-108-109-961-959/index.md#961) [38053](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/addinfo/106-108-109-961-959/index.md#38053) ​ | Additional Information needed from the end user | Additional information required from the end user during an add account event. | | [947](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/invalidtoken/947-2024/index.md#947) [4034](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/invalidtoken/947-2024/index.md#4034) | Invalid Token | Token associated with the end user account has expired or is invalid. | | [331](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/expiredsession/expiredsession/index.md#331) [503](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/expiredsession/expiredsession/index.md#503) [974](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/expiredsession/expiredsession/index.md#974) [1408](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/expiredsession/expiredsession/index.md#1408) [1440](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/expiredsession/expiredsession/index.md#1440) [10022](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/expiredsession/expiredsession/index.md#10022) [10023](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/expiredsession/expiredsession/index.md#10023) | Expired Session | The end user session has either expired or timed out. | | [325](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/325/index.md) | Data Sync in Progress | The account is currently being aggregated. Call the Get Customer Account endpoint periodically to view the account status. The refresh operation is complete when` aggregationStatusCode` is 0 and `aggregationSuccessDate` is greater than or equal to `aggregationAttemptDate`.​ | | [949](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/949/index.md) | Invalid Account | Accounts are in error status and can not be recovered in any way. Delete these accounts. | | [2001](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/consentauth/consentauthorization/index.md#2003) [2003](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/consentauth/consentauthorization/index.md#2003) [2006](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/consentauth/consentauthorization/index.md#2006) [2017](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/consentauth/consentauthorization/index.md#2017) [2024](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/consentauth/consentauthorization/index.md#2024) [2026](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/consentauth/consentauthorization/index.md#2026) [2028](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/consentauth/consentauthorization/index.md#2028) [2030](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/consentauth/consentauthorization/index.md#2030) [2031](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/consentauth/consentauthorization/index.md#2031) [2035](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/consentauth/consentauthorization/index.md#2035) [2036](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/consentauth/consentauthorization/index.md#2036) [2037](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/consentauth/consentauthorization/index.md#2037) [2038](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/consentauth/consentauthorization/index.md#2038) [12005](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/consentauth/consentauthorization/index.md#12005) | Consent Authorization | Occurs when the end user consent authorization is not available. ​ | | [103](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/invalidcredentials/index.md#103) [24303](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/invalidcredentials/index.md#24303) | Invalid Credentials | Occurs when the end user credentials are invalid. | | [324](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/324/index.md) | Account Update Failed | During the add account process an error occurred in the financial institution connection. Submitting a [support ticket](https://developer.mastercard.com/open-finance-us/documentation/support/index.md#create-a-support-case-in-scm) is the recommended action.​ For already added accounts this means that the customer's account information has changed at the financial institution. Submitting a [support ticket](https://developer.mastercard.com/open-finance-us/documentation/support/index.md#create-a-support-case-in-scm) is the recommended action to fix this issue. | | [179](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/unexpectedloginerror/unexpectedloginerror/index.md#179) [1008](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/unexpectedloginerror/unexpectedloginerror/index.md#1008) [2040](https://developer.mastercard.com/open-finance-us/documentation/errors/accounterrors/unexpectedloginerror/unexpectedloginerror/index.md#2040) | Unexpected Login Error | Occurs when the financial institution website returned an unexpected login error. |