# Invalid Request source: https://developer.mastercard.com/open-finance-au/documentation/errors/request/invalidrequest/index.md These errors occur when the request is malformed or incorrect. ​ * [973](https://developer.mastercard.com/open-finance-au/documentation/errors/request/invalidrequest/index.md#973) * [978](https://developer.mastercard.com/open-finance-au/documentation/errors/request/invalidrequest/index.md#978) * [981](https://developer.mastercard.com/open-finance-au/documentation/errors/request/invalidrequest/index.md#981) * [2005](https://developer.mastercard.com/open-finance-au/documentation/errors/request/invalidrequest/index.md#2005) * [10000](https://developer.mastercard.com/open-finance-au/documentation/errors/request/invalidrequest/index.md#10000) * [10001](https://developer.mastercard.com/open-finance-au/documentation/errors/request/invalidrequest/index.md#10001) * [10005](https://developer.mastercard.com/open-finance-au/documentation/errors/request/invalidrequest/index.md#10005) * [10006](https://developer.mastercard.com/open-finance-au/documentation/errors/request/invalidrequest/index.md#10006) * [10010](https://developer.mastercard.com/open-finance-au/documentation/errors/request/invalidrequest/index.md#10010) * [14023](https://developer.mastercard.com/open-finance-au/documentation/errors/request/invalidrequest/index.md#14023) * [20002](https://developer.mastercard.com/open-finance-au/documentation/errors/request/invalidrequest/index.md#20002) * [20024](https://developer.mastercard.com/open-finance-au/documentation/errors/request/invalidrequest/index.md#20024) * [20028](https://developer.mastercard.com/open-finance-au/documentation/errors/request/invalidrequest/index.md#20028) * [38054](https://developer.mastercard.com/open-finance-au/documentation/errors/request/invalidrequest/index.md#38054) * [38056](https://developer.mastercard.com/open-finance-au/documentation/errors/request/invalidrequest/index.md#38056) * [42000](https://developer.mastercard.com/open-finance-au/documentation/errors/request/invalidrequest/index.md#42000) * [42002](https://developer.mastercard.com/open-finance-au/documentation/errors/request/invalidrequest/index.md#42002) * [42003](https://developer.mastercard.com/open-finance-au/documentation/errors/request/invalidrequest/index.md#42003) * [42004](https://developer.mastercard.com/open-finance-au/documentation/errors/request/invalidrequest/index.md#42004) ## 973 {#973} ​ | Title | Details | |---------------------------|------------------------------------------------------------------------------------------------------------------------------------| | **Error Code** | 973 | | **Remediation Category** | Re-Authenticate or Provide Additional Information | | **HTTP Status** | 500 | | **Data Connect Alert** | No associated alert. | | **Error Message** | An error occurred in the financial institution connection. Submitting a support ticket is the recommended action. | | **End User Message** | Suggested end user message - "The user is not authorized for the requested resource or Online access." | | **Common Causes** | This error can occur due to several reasons, such as insufficient permissions or the need for additional verification of the user. | | **Troubleshooting Steps** | Prompt the end user to reconsent access to the specific data resource to proceed. | | **Retriable by End User** | No. | | **Access to Latest Data** | You cannot retrieve the latest data for the user's account until the issue is resolved. | [Full Error List](https://developer.mastercard.com/open-finance-au/documentation/errors/error-list/index.md) ## 978 {#978} | Title | Details | |---------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Error Code** | 978 | | **Remediation Category** | Invalid Input | | **HTTP Status** | 500 | | **Data Connect Alert** | No associated alert. | | **Error Message** | The requested resource is not applicable/supported for this product. | | **End User Message** | Suggested end user message - "The requested resource is not applicable/supported for this product. (partner level, support ticket)." | | **Common Causes** | 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. | | **Troubleshooting Steps** | If the resource you're trying to access is not included in your current integration, consider reaching out to the support team to discuss modifying your plan. You can also submit a [support ticket](https://developer.mastercard.com/open-finance-au/documentation/support/index.md#create-a-support-case-in-scm) to help you resolve this issue. | | **Retriable by End User** | No. | | **Access to Latest Data** | You cannot retrieve the latest data for the user's account until the issue is resolved. | [Full Error List](https://developer.mastercard.com/open-finance-au/documentation/errors/error-list/index.md) ## 981 {#981} | Title | Details | |---------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Error Code** | 981 | | **Remediation Category** | Verify Account or Data State | | **HTTP Status** | 500 | | **Data Connect Alert** | No associated alert. | | **Error Message** | An error occurred in the financial institution connection. Submitting a support ticket is the recommended action. | | **Common Causes** | This error could occur when the end user has not signed up for or activated a specific service or product with their financial institution that your application is trying to access. | | **Troubleshooting Steps** | * Inform the end user that the service or product they are trying to access requires enrollment or activation with their financial institution. Once the end user has enrolled in the necessary service, request them to link their account using Data Connect, * If the issue persists, submit a [support ticket](https://developer.mastercard.com/open-finance-au/documentation/support/index.md#create-a-support-case-in-scm). | | **Retriable by End User** | Yes. | | **Access to Latest Data** | You cannot retrieve the latest data for the user's account until the issue is resolved. | [Full Error List](https://developer.mastercard.com/open-finance-au/documentation/errors/error-list/index.md) ## 2005 {#2005} | Title | Details | |---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Error Code** | 2005 | | **Remediation Category** | Invalid Input | | **HTTP Status** | 400 | | **Data Connect Alert** | No associated alert. | | **Error Message** | An error occurred in the financial institution connection. Submitting a support ticket is the recommended action. | | **End User Message** | Suggested end user message - "We are having problems connecting to your financial institution now. Please try again later​." | | **Common Causes** | This error occurs when your application is trying to access a product or service for which the end user has not granted consent. This situation can arise when the access initially granted does not cover the data being requested. | | **Troubleshooting Steps** | * Review your permissions to understand which products or services the application is authorized to access. * If the application needs access to additional data or products not covered by the initial consent, you need to guide the end user through the process of granting additional permissions. * If the issue persists, submit a [support ticket](https://developer.mastercard.com/open-finance-au/documentation/support/index.md#create-a-support-case-in-scm). | | **Retriable by End User** | No. | | **Access to Latest Data** | You cannot retrieve the latest data for the user's account until the issue is resolved. | [Full Error List](https://developer.mastercard.com/open-finance-au/documentation/errors/error-list/index.md) ## 10000 {#10000} | Title | Details | |---------------------------|--------------------------------------------------------------------------------------------------------------| | **Error Code** | 1000 | | **Remediation Category** | Retry Later | | **HTTP Status** | 500 | | **Data Connect Alert** | No associated alert. | | **Error Message** | General System Error | | **End User Messag** | Suggested end user message - "We ran into a technical issue. Try again later or select another institution." | | **Common Causes** | | | **Troubleshooting Steps** | | | **Retriable by End User** | No. | | **Access to Latest Data** | ?? You cannot access the latest data until the issue is resolved. | [Full Error List](https://developer.mastercard.com/open-finance-au/documentation/errors/error-list/index.md#request-errors) ## 10001 {#10001} | Title | Details | |---------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Error Code** | 10001 | | **Remediation Category** | Invalid Input | | **HTTP Status** | 401 | | **Data Connect Alert** | No associated alert. | | **Error Message** | Invalid credentials​. | | **Common Causes** | This error occurs when the secret you've used in your request is invalid or is not associated to your partnerId. | | **Troubleshooting Steps** | Double-check the secret you are using in your requests is associated to your partnerId. Ensure that there are no typos or spaces before or after the credentials. | | **Retriable by End User** | No. | | **Access to Latest Data** | You cannot access the latest data until the issue is resolved. | [Full Error List](https://developer.mastercard.com/open-finance-au/documentation/errors/error-list/index.md) ## 10010 {#10010} | Title | Details | |---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------| | **Error Code** | 10010 | | **Remediation Category** | Re-Authenticate or Provide Additional Information | | **HTTP Status** | 500 | | **Data Connect Alert** | Please enter all required fields. 10010 ![10010](https://static.developer.mastercard.com/content/open-finance-au/uploads/10010.png) | | **Error Message** | All request parameters could not be validated. Ensure you are sending the correct data in your headers, query parameters, and request body. | | **Common Causes** | This error indicates that the information submitted in your request does not meet the expected format or is missing required fields. | | **Troubleshooting Steps** | Ensure you are sending the correct data in your headers, query parameters, and request body.​ | | **Retriable by End User** | No. | | **Access to Latest Data** | You cannot access the latest data until the issue is resolved. | [Full Error List](https://developer.mastercard.com/open-finance-au/documentation/errors/error-list/index.md) ## 10005 {#10005} | Title | Details | |---------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Error Code** | 10005 | | **Remediation Category** | Re-Authenticate or Provide Additional Information | | **HTTP Status** | 400 | | **Data Connect Alert** | Please enter all required fields. (10005) ![10005](https://static.developer.mastercard.com/content/open-finance-au/uploads/10005.png) | | **Error Message** | A required field was left blank, or contained only whitespace. Submit the request again, with valid text in all required fields. | | **Common Causes** | This error indicates that the information submitted in your request contains whitespace or is missing required fields. | | **Troubleshooting Steps** | Submit the request again, with valid text in all required fields. Before sending your request, trim leading and trailing whitespace from string values. This can help avoid errors where a field appears to be filled but actually contains only whitespace | | **Retriable by End User** | No. | | **Access to Latest Data** | You cannot access the latest data until the issue is resolved. | [Full Error List](https://developer.mastercard.com/open-finance-au/documentation/errors/error-list/index.md) \| **HTTP Status** \| 400 \| \| **Data Connect Alert** \| Please enter all required fields. (10006) \| **Error Message** \| Missing parameter. \| **Common Causes** \| ?? This error indicates that the information submitted in your request contains whitespace or is missing required fields.\| \| **Troubleshooting Steps** \| Submit the request again, with valid text in all required fields. Before sending your request, trim leading and trailing whitespace from string values. This can help avoid errors where a field appears to be filled but actually contains only whitespace \|**Retriable by End User** \| No. \|**Access to Latest Data**\| You cannot access the latest data until the issue is resolved. [Full Error List](https://developer.mastercard.com/open-finance-au/documentation/errors/error-list/index.md#request-errors) --\> ## 14023 {#14023} | Title | Details | |---------------------------|----------------------------------------------------------------------------------------------------------------------------------------| | **Error Code** | 14023 | | **Remediation Category** | Invalid Input | | **HTTP Status** | 404 | | **Data Connect Alert** | No associated error. | | **Error Message** | Invalid Customer ID​. | | **Common Causes** | This error occurs when using an incorrect ID, or attempting to access a customer that does not exist. | | **Troubleshooting Steps** | Verify the customerId used in your request and ensure it matches an existing customer. You can also create a new customerId and retry. | | **Retriable by End User** | No. | | **Access to Latest Data** | You cannot access the latest data until the issue is resolved. | [Full Error List](https://developer.mastercard.com/open-finance-au/documentation/errors/error-list/index.md) ## 20002 {#20002} | Title | Details | |---------------------------|-----------------------------------------------------------------------| | **Error Code** | 20002 | | **Remediation Category** | Verify Account or Data State | | **HTTP Status** | 409 | | **Error Message** | Pay statement already exists for a given Asset ID​. | | **Common Causes** | | | **Troubleshooting Steps** | Prompt end user to reconsent to the specific data resource to proceed | | **Retriable by End User** | No. | | **Access to Latest Data** | Not applicable. | [Full Error List](https://developer.mastercard.com/open-finance-au/documentation/errors/error-list/index.md) --\> ## 20024 {#20024} | Title | Details | |---------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Error Code** | 20024 | | **Remediation Category** | Invalid Input | | **HTTP Status** | 404 | | **Data Connect Alert** | Not associated alert. | | **Error Message** | Invalid Routing Number​. | | **Common Causes** | The error indicates that the routing number provided in your request does not match any financial institution or is not in the correct format | | **Troubleshooting Steps** | Double-check the routing number is accurate and adheres to the standard format. If the issue persists, submit a [support ticket](https://developer.mastercard.com/open-finance-au/documentation/support/index.md#create-a-support-case-in-scm). | | **Retriable by End User** | No. | | **Access to Latest Data** | You cannot access the latest data until the issue is resolved. | [Full Error List](https://developer.mastercard.com/open-finance-au/documentation/errors/error-list/index.md) ## 20028 {#20028} | Title | Details | |---------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Error Code** | 20028 | | **Remediation Category** | Verify Account or Data State | | **HTTP Status** | 404 | | **Error Message** | Invalid Real Account Number​. | | **Common Causes** | It indicates that the account number provided in your request does not match any account in our records or is not in the correct format. | | **Troubleshooting Steps** | Double-check the account number is accurate and adheres to the standard format. If the issue persists, submit a [support ticket](https://developer.mastercard.com/open-finance-au/documentation/support/index.md#create-a-support-case-in-scm). | | **Retriable by End User** | No. | | **Access to Latest Data** | You cannot access the latest data until the issue is resolved. | [Full Error List](https://developer.mastercard.com/open-finance-au/documentation/errors/error-list/index.md) ## 38054 {#38054} | Title | Details | |---------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Error Code** | 38054 | | **Remediation Category** | Invalid Input | | **HTTP Status** | 400 | | **Error Message** | Error while processing image. | | **Common Causes** | This error indicates that the data provided in your request does not meet the expected format, is incomplete, or contains invalid values | | **Troubleshooting Steps** | Ensure all fields are present, correctly formatted, and contain valid values. If the issue persists, submit a [support ticket](https://developer.mastercard.com/open-finance-au/documentation/support/index.md#create-a-support-case-in-scm). | | **Retriable by End User** | No. | | **Access to Latest Data** | You cannot access the latest data until the issue is resolved. | [Full Error List](https://developer.mastercard.com/open-finance-au/documentation/errors/error-list/index.md#request-errors) ## 38056 {#38056} | Title | Details | |---------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Error Code** | 38056 | | **Remediation Category** | Invalid Input | | **HTTP Status** | 400 | | **Error Message** | Invalid input data​. | | **Common Causes** | This error indicates that the data provided in your request does not meet the expected format, is incomplete, or contains invalid values | | ==== BASE ==== | | | **Troubleshooting Steps** | Ensure all fields are present, correctly formatted, and contain valid values. If the issue persists, submit a [support ticket](https://finicity.atlassian.net/servicedesk/customer/portal/13). | | ==== BASE ==== | | | **Retriable by End User** | No. | | **Access to Latest Data** | You cannot access the latest data until the issue is resolved. | [Full Error List](https://developer.mastercard.com/open-finance-au/documentation/errors/error-list/index.md) ## 42002 {#42002} | Title | Details | |---------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Error Code** | 42002 | | **Remediation Category** | Report or Escalate for Investigation | | **HTTP Status** | 503 | | **Error Message** | Aggregation service is temporarily unavailable. Please try again later​. | | **Common Causes** | This error occurs when a recent request to retrieve latest data coincides with an ongoing data synchronization for the same account. A new refresh cannot be initiated until the current one completes. This is a common scenario when multiple refresh requests are sent in a short period.​​ | | **Troubleshooting Steps** | * **Wait and retry**: Wait for a short period (3-5 minutes) before retrying the request. This gives the current refresh operation time to complete. * **Check account status** : Call the [Get Customer Account](https://developer.mastercard.com/open-finance-au/documentation/api-reference/index.md#GetCustomerAccounts) endpoint periodically to view the account status. When the data refresh process is successfully completed, `aggregationStatusCode` will return value as 0 and `aggregationSuccessDate` will be greater than or equal to the `aggregationAttemptDate`. | | **Retriable by End User** | No. | | **Access to Latest Data** | You cannot access the latest data until the issue is resolved. | [Full Error List](https://developer.mastercard.com/open-finance-au/documentation/errors/error-list/index.md) ## 42003 {#42003} | Title | Details | |---------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Error Code** | 42003 | | **Remediation Category** | Report or Escalate for Investigation | | **HTTP Status** | 403 | | **Connect Alert** | We ran into a technical issue, try again later or select another institution. (42003) ![42003](https://static.developer.mastercard.com/content/open-finance-au/uploads/42003.png) | | **Error Message** | Testing customer should not add real accounts​. | | **Common Causes** | This error occurs when you attempt to add real account for test customers. | | **Troubleshooting Steps** | Use active customers to connect live FIs. ​Use test credentials and simulated data for development and testing purposes, rather than connecting to real financial account. | | **Retriable by End User** | No. | | **Access to Latest Data** | You cannot access the latest data until the issue is resolved. | [Full Error List](https://developer.mastercard.com/open-finance-au/documentation/errors/error-list/index.md) ## 42004 {#42004} | Title | Details | |---------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Error Code** | 42004 | | **Remediation Category** | Report or Escalate for Investigation | | **HTTP Status** | 403 | | **Connect Alert** | We ran into a technical issue, try again later or select another institution. (42004) ![42004](https://static.developer.mastercard.com/content/open-finance-au/uploads/42004.png) | | **Error Message** | Trouble communicating with servers. Billable customer should not add testing accounts. ​ | | **Common Causes** | This error occurs when customers who are billed attempt to add test accounts in production. | | **Troubleshooting Steps** | Customers who are billed should avoid using test accounts in production. Use active customers to connect live FIs. ​Use test credentials and simulated data for development and testing purposes, rather than connecting to real financial account. | | **Retriable by End User** | No. | | **Access to Latest Data** | You cannot access the latest data until the issue is resolved. | [Back to top](https://developer.mastercard.com/open-finance-au/documentation/errors/request/invalidrequest/index.md#973) [Full Error List](https://developer.mastercard.com/open-finance-au/documentation/errors/error-list/index.md)