Minor versions

The QuickBooks Online API supports minor versions in order to provide a way for you to access incremental changes without breaking existing apps.

Working with minor versions

Use the minorversion query parameter in REST API requests to access a version of the API other than the generally available version. For example, to invoke minor version 1 of the JournalEntry entity, issue the following request:
https://quickbooks.api.intuit.com/v3/company/<realmID>/journalentry/entityId?minorversion=1
XSD download available when generating your own deserialized classes. See table below for links.
Minor version changes can be accessed on a per-resource basis. There is no need to apply a minor version to all resources unless you wish to do so.

Using the SDK with minor versions

The SDK version noted in the Minimum SDK Version column of the table below automatically accesses the features of the given minor version and all prior versions.
Once a newer version of SDK is released, update your code to take advantage of new features and new minor version support. Apps using older version of the SDK will continue to run, however.

Minor version summary

MINOR VERSION	RELEASE DATE	MINIMUM SDK VERSION	NEW FEATURES
42	November 22, 2019		Includes all minor versions 1 through 41, plus the addition of the following: Added `Thresholds` field for `Entitlements`. XSD
41	September 24, 2019		Includes all minor versions 1 through 40, plus the addition of the following: Added support to associate a `Class` for an `Item`. Use `Item->ClassRef` XSD
40	July 30, 2019		Includes all minor versions 1 through 39, plus the addition of the following: Added `IncludeInAnnualTPAR` field for `Bill`. Added `IncludeInAnnualTPAR` field for `Purchase`. Added `HasTPAR` field for `Vendor`. Added `IncludeInAnnualTPAR` field for `VendorCredit`. Added `VendorAndPurchasesPrefs.TPAREnabled` field for `Preferences`. Added `VendorPaymentBankDetail` field for `Vendor`. No schema change.
39	July 19, 2019	Internal Only	Includes all minor versions 1 through 38, plus the addition of the following: No schema change.
38	May 9, 2019		Includes all minor versions 1 through 37, plus the addition of the following: Added support to link `BillPayment` to `JournalEntry` at transaction level. Added support to link `BillPayment` to `Bill`, `Deposit`, `JournalEntry` and `VendorCredit` at line level. Available with minor version 38. Added support to link `Bill` to multiple `Purchase Order` at both transaction level and line level. Added new field `Received` for PurchaseOrder. XSD
37	March 26, 2019		Includes all minor versions 1 through 36, plus the addition of the following: Added support to link `Invoice` to `CreditMemo` for GST compliance. ( IN Locale only ) Available with minor version 37. XSD
36	February 13, 2019		Includes all minor versions 1 through 35, plus the addition of the following: Added support for getting Payment link for Invoices via API XSD
35	December 4, 2018		Includes all minor versions 1 through 34, plus the addition of the following: Added support for ShipFromAddr field in Invoice, SalesReceipt and Estimate to support Automated Sales Tax. XSD
34	November 21, 2018		Includes all minor versions 1 through 33, plus the addition of the following: Added support for TaxClassificationService which provides APIs for read operations on Tax Classification
33	December 18, 2018		Includes all minor versions 1 through 32, plus the addition of the following: Added support for GST complaint invoices for India. XSD
32	October 11, 2018	Java: 4.0.0 .NET 5.0.0 PHP: 4.0.4	Includes all minor versions 1 through 30, plus the addition of the following: Added ability to determine if a company is enabled for Progressive Invoicing. Use Preferences->SalesFormsPrefs->UsingProgressInvoicing No schema change.
31	October 11, 2018	Java: 4.0.0 .NET 5.0.0 PHP: 4.0.4	Includes all minor versions 1 through 30, plus the addition of the following: Added ability to add PreferredVendor to a Product. Use Item->PrefVendorRef
30	September 13, 2018	Java: 4.0.0 .NET 5.0.0 PHP: 4.0.4	Includes all minor versions 1 through 29, plus the addition of the following: For Description Only lines in sales transactions, Line.Amount is now returned if set with the QuickBooks UI. No schema change.
29	August 23, 2018		Includes all minor versions 1 through 28, plus the addition of the following: Added new OfferingSKU value “QuickBooks Online Advanced” in CompanyInfo API No schema change.
28	July 25, 2018		Includes all minor versions 1 through 27, plus the addition of the following: Used for returning NonTracking status from the CompanyInfo API. No schema change.
27	July 25, 2018		Includes all minor versions 1 through 26, plus the addition of the following: Added preferences attribute to set custom transaction numberVendorAndPurchasesPrefs No schema change.
26	June 21, 2018	Java: 4.0.5 .NET 5.0.0	Includes all minor versions 1 through 25, plus the addition of the following: Added employee reference number for V4 API. XSD
25	Internal, only		Includes all minor versions 1 through 24, plus the addition of the following: Added ability to distinguish between sub-customer and Projects. Use Customer->IsProject No schema change.
24	October 11, 2018	Java: 4.0.4 .NET 5.0.0 PHP: 4.0.4	XSD
23	March 26, 2018	Java: 4.0.0 .NET 5.0.0 PHP: 4.0.4	Includes all minor versions 1 through 22, plus the addition of the following: For Description Only lines in sales transactions, Line.Amount is now returned if set with the QuickBooks UI. No schema change.
22	March 26, 2018	Java: 4.0.0 .NET 5.0.0 PHP: 4.0.4	Includes all minor versions 1 through 21, plus the addition of the following: New preferences. No schema change.
21	March 8, 2018	Java: 4.0.0 .NET 5.0.0 PHP: 4.0.4	Includes all minor versions 1 through 20, plus the addition of the following: Preferences now in parity with those available via UI. `FreeFormAddress` to specify how `ShipAddr` is stored for sales transactions. XSD
19	March 26, 2018	Java: 4.0.0 .NET 5.0.0 PHP: 4.0.4	Includes all minor versions 1 through 18, plus the addition of the following: Lines for Deposit objects having a description of Exchange Gain Or Loss can now be suppressed from the response payload. No schema change.
17	March 26, 2018	Java: 4.0.0 .NET 5.0.0 PHP: 4.0.4	Includes all minor versions 1 through 15, plus the addition of the following: The purchase order resource now supports the vendor emaill attribute, PurchaseOrder.POEmail. No schema change.
15, 16, 18, 20	N/A	N/A	Internal, only. No schema change.
14	December 18, 2017	Java: 2.9.6 .NET 3.2.1 PHP: 3.2.6	Includes all minor versions 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 and 13, plus the addition of the following: Invoice objects specifying a deposit are not created if `Preferences.SalesFormsPrefs.AllowDeposit` is set to false for the company. XSD
13	October 30, 2017	Java: 2.9.6 .NET 3.2.1 PHP: 3.2.6	Includes all minor versions 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, and 12, plus the addition of the following: Support for additional `account.accountsubtype` values. See Account for details. XSD
12	June 30, 2017	Java: 2.9.6 .NET 3.2.1 PHP: 3.2.6	Includes all minor versions 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, and 11, plus the addition of the following: Support for `VendorCredit.Balance` field. XSD
11	May 27, 2017	Java: 2.9.3 .NET: 3.1.0 PHP: 3.2.6	Includes all minor versions 1, 2, 3, 4, 5, 6, 7, 8, 9, and 10, plus the addition of the following: Support for CompanyInfo sparse update. Validation on `CompanyInfo.CompanyAddr` field. XSD
10	April 25, 2017	Java: 2.9.3 .NET: 3.1.0	Includes all minor versions 1, 2, 3, 4, 5, 6, 7, 8, and 9, plus the addition of the following: Support for `Customer.taxExemptionReasonId`. XSD
9	April 25, 2017	Java: 2.9.3 .NET: 3.1.0	Includes all minor versions 1, 2, 3, 4, 5, 6, 7 and 8, plus the addition of the following: Support for reimbursable charges. XSD
8	November 15, 2016	Java: 2.7.1 .NET: 2.8.0 PHP: 3.2.4	Includes all minor versions 1, 2, 3, 4, 5, 6, and 7, plus the addition of the following: Support for carbon copy and blind carbon copy email addresses in Invoice objects. XSD
7	Internal, only.
6	February 17, 2016	Java: 2.5.0 .NET: 2.4.0 PHP: 2.2.0	Includes all minor versions 1, 2, 3, 4, and 5, plus the addition of the following: Global (non-US) support for `TaxAgency:LastFileDate`. XSD
5	December 18,2015	Java: 2.4.0 .NET: 2.4.0 PHP: 2.5.0	Includes all minor version 1, minor version 2, minor version 3, and minor version 4 plus the addition of the following: France-local Plan Comptable General (PCG) support. XSD
4	Phase 1—September 24, 2015	Java: 2.4.0 .NET: 2.4.0 PHP: 2.2.0	Includes all minor version 1, minor version 2, and minor version 3 plus the addition of the following: In support of enhanced inventory, the following are added to the Item resource: `Item.Sku` attribute. `NonInventory` to the list of valid `Item.Type` selections. Support for line-level discounts with the `DiscountAmt` and `DiscountRate` attributes in a `SalesLineDetail` element for FR locales.
4	Phase 2—November 19, 2015	Java: 2.4.0 .NET: 2.4.0 PHP: 2.2.0	Includes all minor version 1, minor version 2, minor version 3, and phase 1 of minor version 4 plus the addition of the following: Images with item objects, via the Attachable resource. See Item hierarchies with the `Category` item type. Support for transaction-level tax calculations with the `TxnTaxDetail` element in Deposit objects for non-US locales. XSD
3	Phase 1—May 29, 2015	Java: 2.4.0 .NET: 2.4.0 PHP: 2.2.0	Includes all minor version 1 and minor version 2 plus the addition of the following: Reports APIs Reports API response for General Ledger report hierarchy is broken in certain circumstances when there are sub accounts configured in the QuickBooks company.
3	Phase 2—August 11, 2015	Java: 2.4.0 .NET: 2.4.0 PHP: 2.2.0	Includes all minor version 1, minor version 2, and phase 1 of minor version 3 plus the addition of the following: Transaction entities: `HomeBalance` field to track transaction balance in home currency. Available with bill, creditmemo, invoice, refundreceipt, and salesreceipt. `GlobalTaxCalculation` attribute for Deposit entity. `TaxCodeRef` attribute for Account entity. For India locales: Sales tax enhancements. For France locales: New JournalCode resource, `Item.ItemCategoryType`, new Vendor fields, new Customer fields.
3	Phase 3—August 27, 2015	Java: 2.4.0 .NET: 2.4.0 PHP: 2.2.0	Includes all minor version 1, minor version 2, and phases 1 and 2 of minor version 3 plus the addition of the following: Transaction entities: `Account.TaxCodeRef` attribute to specify the default tax code used for the account—available for global locales, only. `Preferences.TaxPrefs.PartnerTaxEnabled` to enable the QuickBooks Online sales tax engine. XSD
2	March 25 2015	PHP: 2.1.0	Minor version 2 includes all minor version 1 items plus the addition of the following: Reports APIs for detailed report types: Addition of `ColKey` metadata in report header which provides sub-classification of ColType. Date format of `YYYY-MM-DD` is used instead of that defined in company preferences. This will be generally available in QuickBooks Online services v85. Transaction entities: Transaction tax type as defined in company setting is now used instead of always defaulting to `Exclusive`. (international QBO only). Further information to be provided. XSD
1	March 7 2014	Java: 2.1.2 .NET: 2.0.4 PHP: 2.0.4	-Addition of `TaxInclusiveAmt` attribute `Line.SalesItemLineDetail`, `Line.ItemBasedExpenseLineDetail`, and `Line.AccountBasedExpenseLineDetail` line types. Available for international editions of QBO, only. -Addition of `TotalAmt` and `HomeTotalAmt` (international QBO only) attributes to JournalEntry entity. XSD
pre-1	Legacy V3	Java: <=2.1.0 .NET: 2.0.0 PHP: 2.0.0	Legacy V3