# 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 and aggregation status codes. For a list of all the Mastercard Open Finance error codes, see the [Full Error List](https://developer.mastercard.com/open-finance-us/documentation/errors/error-list/index.md) ## Account Errors {#account-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 engages in several processes, such as financial institution discovery, account selection, account permissioning, and authentication flow. 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 API call returns an error, the error directs the partner to take the recommended action and resolve errors where applicable. * **Scheduled or manual data refresh** : Mastercard schedules data refreshes (aggregation) 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, Mastercard updates the `aggregationStatusCode` to a non-zero value that indicates the nature of the failure, 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 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" } ] } ``` Warning: We recommend that you listen for and catch non-zero aggregation status codes, and invoke [Data Connect Fix](https://developer.mastercard.com/open-finance-us/documentation/products/manage/aggregation-status-codes/index.md#using-data-connect-fix) where appropriate. For errors which are not fixable in this way, see the [Full Error List](https://developer.mastercard.com/open-finance-us/documentation/errors/error-list/index.md) section for further suggestions. In some cases you may need to submit a support request. The following table lists the different error states that may occur during the aggregation process. | Status Codes | Theme | Description | |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [909](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/909/index.md) [913](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/913/index.md) [914](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/914/index.md) [946](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/946/index.md) [952](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/952/index.md) [38003](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/38003/index.md) | Account Not Found | Bank account cannot be found at the financial institution. | | [185](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/185/index.md) [187](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/187/index.md) [931](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/931/index.md) [938](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/938/index.md) [940](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/940/index.md) [12003](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/12003/index.md) | Incomplete Authorization | Inadequate response to security questions from the end user. | | [106](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/106/index.md) [108](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/108/index.md) [109](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/109/index.md) [936](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/936/index.md) [959](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/959/index.md) [961](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/961/index.md) [981](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/981/index.md) [38053](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/38053/index.md) | Additional Information needed from the end user | Additional information required from the end user during an add account event. | | [168](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/168/index.md) [169](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/169/index.md) | Duplicate account | An account in the return data matches multiple requested accounts. Have the customer keep one account and delete the duplicate(s) in Data Connect. | | [945](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/945/index.md) | OAuth migration (account migrated but not consented) | Prompt the end user to re-authenticate via Data Connect Fix. If Data Connect fix isn't integrated, have the customer delete the account and add it again under the same bank with the OAuth connection indicated in the 'Institution Search' list. | | [946](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/946/index.md) | Account not found (account may have been closed) | Prompt the end user to authenticate the right account via Data Connect Fix. If Data Connect fix isn't integrated, have the customer delete the account and then find and add an active account in Data Connect. | | [947](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/947/index.md) [4034](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/4034/index.md) | Invalid Token | Token expired or refresh required, token associated with the end user account has expired or is invalid. | | [948](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/948/index.md) | OAuth migration (account migrated but not authenticated) | Prompt the end user to re-authenticate via Data Connect Fix. If Data Connect fix isn't integrated, have the customer delete the account and add it again under the same bank with the OAuth connection indicated in the 'Institution Search' list. | | [951](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/951/index.md) [953](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/953/index.md) [979](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/979/index.md) [980](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/980/index.md) [983](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/983/index.md) | Connection Error | Connection is interrupted temporarily due to an unexpected error. | | [325](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/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/error-codes/949/index.md) | Invalid Account | Accounts are in error status and can not be recovered in any way. Delete these accounts. | | [924](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/924/index.md) [972](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/972/index.md) [976](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/976/index.md) | Unsupported Product | This error could occur when an institution does not support aggregation or some of the Open Finance products. | | [975](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/975/index.md) | User Unauthorized | This error is caused when the end user is not authorized to access their accounts due to security reasons. | | [977](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/977/index.md) | Maximum Limit Exceeded | The number of requests to a particular financial institution exceeds the set rate limit. | | [978](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/978/index.md) | Unsupported Product | This error can occur when the operation you are attempting to perform or the data you are trying to access is not available within the scope of your current contract with Mastercard. | | [991](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/991/index.md) | Unexpected System Error | An error occurred in our internal system. | | [1007](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/1007/index.md) | Empty Date Range | No transactions found within the specified date range during transaction aggregation. | | [2001](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/2001/index.md) [2003](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/2003/index.md) [2006](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/2006/index.md) [2017](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/2017/index.md) [2024](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/2024/index.md) [2026](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/2026/index.md) [2028](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/2028/index.md) [2030](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/2030/index.md) [2031](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/2031/index.md) [2035](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/2035/index.md) [2036](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/2036/index.md) [2037](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/2037/index.md) [2038](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/2038/index.md) [12005](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/12005/index.md) | Consent Authorization | Occurs when the end user consent authorization is not available. | | [103](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/103/index.md) [24303](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/24303/index.md) | Invalid Credentials | Occurs when the end user credentials are invalid. | | [324](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/324/index.md) [910](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/910/index.md) [418](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/418/index.md) [419](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/419/index.md) [907](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/907/index.md) [970](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/970/index.md) | Account Update Failed | 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. | | [102](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/102/index.md) | Connection Interrupted | The bank may have updated its website or server. These changes can disrupt the connection between your app and the bank, requiring changes/updates to restore the original connection. | | [179](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/179/index.md) [1008](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/1008/index.md) [2040](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/2040/index.md) | Unexpected Login Error | Occurs when the financial institution website returns an unexpected login error. | | [130](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/130/index.md) [147](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/147/index.md) [148](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/148/index.md) [170](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/170/index.md) [173](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/173/index.md) [176](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/176/index.md) [181](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/181/index.md) [190](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/190/index.md) [417](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/417/index.md) [900](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/900/index.md) [901](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/901/index.md) [903](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/903/index.md) [904](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/904/index.md) [906](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/906/index.md) [907](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/907/index.md) [950](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/950/index.md) [973](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/973/index.md) [982](https://developer.mastercard.com/open-finance-us/documentation/errors/error-codes/982/index.md) | Additional Support Required | Submit a [support ticket](https://developer.mastercard.com/open-finance-us/documentation/support/index.md#create-a-support-case-in-scm). |