REMINDER: UPCOMING CHANGES TO ACCOUNTING API MINOR VERSIONS 

Hello Intuit Developer, 

We're contacting you because you or your team have developed a QuickBooks Online application that uses our Accounting API. As a follow-up to previous emails, this is a reminder that support for minor versions 1 through 74 of the QuickBooks Online Accounting API will end on August 1, 2025. We request that you review your app's usage of these minor versions and make any necessary updates before July 31, 2025.

What is happening?

Beginning August 1, 2025, we will be deprecating support for minor versions 1–74. All API requests to the Accounting API will use the minor version 75 by default and previous minor versions will be ignored.

This update doesn't apply to users of our Desktop, Payments, or Payroll APIs as these APIs don't use minor versions.

You can find more information in this article on the Intuit Developer blog. 

How does this impact me?

If you have or maintain an app on developer.intuit.com and use our Accounting API, you may be impacted.

In your API request, if you specify a value for the minorversion parameter that is less than 75, it will be ignored and the system will respond with data corresponding to minor version 75.

If you don't specify a minor version in your request, the response will default to minor version 75 rather than the base version.

Any future updates to the Accounting API that aren't backward compatible will be released under new minor versions (for example, field or feature removals, and updates to enum fields). However, changes such as the addition of new fields to the schema won't trigger a minor version update. This will ensure that all apps benefit from any bug fixes or new features without having to maintain minor versions. Details of new features will be included in future release notes and newsletters. 

What do I need to do?

1. If you aren't using minor versions in your API requests, ensure your code is compatible with minor version 75 and the corresponding schema.

2. If you are using minor versions in your API requests, update your requests to use minor version 75. For example, your requests may look like this:

https://quickbooks.api.intuit.com/v3/company/<realmId>/<apiEntity>/entityId?minorversion=75

3. If you are using our Java SDK, there are 3 options:

• If you would like to use the SDK compatible with Java 8, then update it to version 6.5.0.
• If you would like to use the SDK compatible with Java 17, then update it to version 6.7.0.
• If you would like to use the SDK compatible with Java 21, then update it to version 6.6.0.

4. If you are using our PHP SDK, then update it to the latest version 6.2.0

5. If you are using our .Net SDK, then update it to the latest version 14.7.0

6. If you aren't using any of our SDKs, ensure your code is compatible with minor version 75 and the corresponding schema.

7. Ensure your code can handle future additions to the schema. You can do this by ignoring unknown fields so your app isn't impacted when we release new fields in the future. 

When do I need to take action?

Be sure you take action by July 31, 2025. Although we will implement this change in a phased manner, the API will start returning responses for minor version 75 beginning August 1, 2025. 

How do I test my changes?

Support for minor versions 1-74 has been removed from the sandbox environment. All Accounting API requests in Sandbox will return responses corresponding to minor version 75 only. Please use this environment to test your app against minor version 75 to ensure compatibility. 

What happens if I don't take any action?

Depending on how you are processing our Accounting API response, your app may be negatively affected if it doesn't handle new API fields introduced in the latest minor versions. 

What if I have additional questions?

Review our blog post to review answers to additional questions. You can also connect with our developer support team by submitting a ticket or asking a question on our forums.

Our developer support team is hosting an office hour session to address your questions about this upcoming change on May 1, 2025 from 10 AM to 12 PM Pacific Time. Please sign up for the April session by April 28, 2025 using this link. Look for information about registering for an upcoming office hour session in our next email alert.