QuickBooks Online API Release Notes

QuickBooks Online API XSDs

Click to see list.
VersionRelease DateLink
v3, minor version 30September 13, 2018Feature change, only. No schema change.
v3, minor version 29August 23, 2018Feature change, only. No schema change.
v3, minor version 28July 25, 2018Feature change, only. No schema change.
v3, minor version 27July 25, 2018Feature change, only. No schema change.
v3, minor version 26June 21, 2018v3_minor_version_26.zip
v3, minor version 25Internal onlyFeature change, only. No schema change.
v3, minor version 24Internal onlyv3_minor_version_24.zip
v3, minor version 23March 26, 2018Feature change, only. No schema change.
v3, minor version 22March 26, 2018Feature change, only. No schema change.
v3, minor version 21March 7, 2018v3 minor version 21.zip
v3, minor version 19March 26, 2018Feature change, only. No schema change.
v3, minor version 17March 26, 2018Feature change, only. No schema change.
v3, minor versions 15,16, 18, 20Internal, only. No schema change.
v3, minor version 14December 18, 2017v3 minor version 14.zip
v3, minor version 13October 30, 2017v3 minor version 13.zip
v3, minor version 12June 30, 2017v3 minor version 12.zip
v3, minor version 11May 27, 2017v3 minor version 11.zip
v3, minor version 10April 25, 2017

v3 minor version 10.zip

v3, minor version 9April 25, 2017v3 minor version 9.zip
v3, minor version 8November 22, 2016v3 minor version 8.zip
v3, minor version 7July 27, 2016v3 minor version 7.zip
v3, minor version 6February 17, 2016v3 minor version 6.zip
v3, minor version 5December 15, 2015v3 minor version 5.zip
v3, minor version 4

Phase 1—September 24, 2015
Phase 2—November 19, 2015

v3 minor version 4.zip
v3, minor version 3

Phase 1—May 29, 2015
Phase 2—August 11, 2015
Phase 3—August 27, 2015

V3 minor version 3.zip
v3, minor version 2March 27, 2015V3 minor version 2.zip
v3, minor version 1March 6, 2014V3 minor version 1.zip

QuickBooks Online v1809

Date: September 13, 2018

  • Added ability to determine if a company is enabled for Gratuity (Tips). i.e. “OtherPrefs->Name->SalesFormsPrefs.AllowGratuity” and OtherPrefs->Name->SalesFormsPrefs.GratuityAccount. Available with minor version 30.
  • Added ability to send tips in SalesReceipt for Gratuity enabled companies
  • Resolved Issues:
  • ACCTG-15090 - Querying ExchangeRate via POST operation, with query in body returns a NullPointerException
  • ACCTG-15022 - Invalid Vendor query returns ClassCastException
  • QBO-210133 - Invoice update returns stale data 

QuickBooks Online v1808

Date: August 23, 2018

  • Added new OfferingSKU value "QuickBooks Online Advanced" in CompanyInfo API. Available with minor version 29.
  • Added ability to allow editing Expense transaction transaction number preferences. i.e. “VendorAndPurchasesPrefs.UseCustomTxnNumbers”. Available with minor version 27.
  • Resolved Issues:
  • ACCTG-9125 - Return "linenum" field for PurchaseOrder line items
  • ACCTG-9026 - Fixed incorrect validation for SalesReceipt - TrackingNum field
  • ACCTG-13477 - Fixed incorrect linked transaction id returned for Invoices linked to Estimates
  • ACCTG-13564 - Resolved Invoice query failure for minor version 23 and above.
  • ACCTG-14012 - Resolved incorrect descriptionlinedetail error for PurchaseOrder

QuickBooks Online v1807

Date: July 25, 2018

  • Added "NonTracking" status to CompanyInfo API. Available with minor version 28.
  • Resolved Issues:
  • ACCTG-13121 - Update CashFlow report to return "Net cash provided by operating activities" data
  • ACCTG-12940 - Allow global companies to create tax rate with negative values
  • ACCTG-12924 - Fixed NullPointerException while querying invoices using minor version 21 or higher
  • ACCTG-12767 - Allow TaxExemptionReasonId to be returned in Query API response
  • ACCTG-12465 - Return correct error message when employee name field length is incorrect
  • ACCTG-12246 - TimeActivity should not allow billableStatus to be set if the MarkTimeEntriesBillable setting on UI is disabled.
  • ACCTG-9140 - Allow Place of Purchase field for France to be returned in Query API response

QuickBooks Online v1806

Date: June 21, 2018

  • Added employee reference number for V4 API Employee.V4IDPseudonym Available with minor version 26.
  • Resolved Issues:
  • ACCTG-10882 - GeneralLedger report returns incorrect ColKey Name,Value for Debit and Credit column
  • ACCTG-9908 - For France, Sales txn subtotal is incorrect when line item/txn level discount is use

QuickBooks Online v1805

Date: May 26, 2018

  • Resolved Issues:
  • ACCTG-11164 - Fixed NullPointerException for AST enabled companies during Invoice creation caused due to blank postal code in billing address
  • ACCTG-6894 - Fixed NullPointerException for AST enabled companies during Invoice creation caused due to invalid contact address

QuickBooks Online v1804

Date: April 25, 2018

  • Resolved Issues:
  • ACCTG-4804 - Fixed BusinessValidation error caused due to missing TxntaxDetailLine when multiple lines are present.

QuickBooks Online v1803

Date: March 26, 2018

  • The purchase order resource now supports the vendor emaill attribute, PurchaseOrder.POEmail. Available with minor version 17.
  • Lines for Deposit objects having a description of  Exchange Gain Or Loss can now be suppressed from the response payload. Available with minor version 19.
  • The following preferences have been added to those already returned in the Preference response payload. Available with minor version 22:
  • For Description Only lines in sales transactions, Line.Amount is now returned if set with the QuickBooks UI. Available with minor version 23.

QuickBooks Online v1802

Date: March 7, 2018

  • QuickBooks Online API issue status is now available on the Developer portal at this location. This replaces statuses formerly reported in these release notes and in other locations throughout the documentation. 
  • The set of preferences available via the API is now in parity with those in the QuickBooks Online UI. The following have been added to those already returned in the Preference response payload. Available with minor version 21.


  • A new flag, FreeFormatAddress, is now supported for sales transactions to denote how the shipping address is stored: formatted or free form. The value of this flag is system defined based on format of shipping address at object create time. Available with minor version 21.
    • true—shipping address is returned in free formatted style using Line1 through Line5 attributes.
    • false—shipping address is returned in formatted style using City, Country, CountrySubDivisionCode, Postal code.

QuickBooks Online v1801

Internal, only.

QuickBooks Online v1712

Date: December 18, 2017

  • Deposit references in Invoice objects
    For companies that don't allow deposits (Preferences.SalesFormsPrefs.AllowDeposit is set to false), invoice objects that specify a deposit cannot be created. Available with minor version 14. 
  • Resolved issues
    • QBO-119872: Line items with unit price or rate of 0 are now correctly created in VendorCredit objects.
    • QBO-147654: BillPayment.DocNum is now correctly incremented when Preferences.CustomerTxnNumber is set to false.
    • QBO-155969: JournalEntry.DocNum is now correctly created when Preferences.CustomerTxnNumber is set to false.
    • QBO-163026: TxnTaxDetail elements, instead of Line elements, are now correctly generated to hold tax information with all minor version specifications. (UK locale)
    • QBO-166637: Queries with Invoice.TxnDate now return correct list of objects. (UK, AU, IN locales)
    • QBO-176146: Term.DueNextMonthDays can now be set to 0.
    • QBO-178824: Queries for TimeActivity objects now return the correct result set.
    • QBO-182183: Problem corrected when certain JournalCode queries returned a System Failure error.
    • QBO-184478: Correct error code (2050) is now returned when Customer.WebAddr exceeds 1000 characters in length.
    • QBO-185555: DescriptionOnly lines for Invoice objects are now returned correctly with all minor version specifications.
    • QBO-187714: TaxAgency.LastFileDate is now returned in TaxAgency objects with minor version 6 specified.

QuickBooks Online v1711

Date: November 10, 2017

  • Automated sales tax
    As of November 10, 2017, all new US QuickBooks Online companies manage sales tax calculations via an automated sales tax (AST) engine. Sales tax is computed automatically on the sales transaction based upon the shipping address and the location of the company rather assigning sales tax manually. Read more about how QuickBooks Online implements automated sales tax here and here for information about using the QuickBooks Online API with companies using automated sales tax.

QuickBooks Online v1710

Date: October 30,2017

  • The account.acctsubtype attribute now supports additional sub-account types. See Account in the API Reference for details. Available with minor version 13.
  • Resolved issues
    • QBO-186184: New sub-accounts are now available via the API.

QuickBooks Online v1709

Date: October 6, 2017

  • Maximum phone number length is increased to 30 characters.
  • Resolved issues
    • QBO-185474: Chart of accounts now loads all records for sandbox companies.
    • QBO-168577: Send operations for Invoice, SalesReceipt, and Estimate objects now send email to addresses stored in the BillEmailCC and BillEmailBCC attributes.

QuickBooks Online v1708

Internal, only.

QuickBooks Online v1707

Internal, only.

QuickBooks Online v1706

Date: June 30,2017

  • Full support for Australian Tax Office (ATO) Simpler BAS now available to both sandbox and production companies. Click here for further information about ATO Simpler BAS and how QuickBooks Online supports it via Simpler GST tax codes.
  • The VendorCredit resource now supports the Balance parameter. Available with minor version 12.

QuickBooks Online v1705

Date: May 27, 2017

  • Support for Australian Tax Office (ATO) Simpler BAS is now available in QuickBooks Online sandbox companies for the AU locale. Full support in AU-locale production companies is available July 1, 2017. Click here for further information about ATO Simpler BAS and how QuickBooks Online supports it via Simpler GST tax codes.
  • The sparse update operation for CompanyInfo now supported. available with minor version 11.
  • Allowed attachable file types: starting June 12, 2017 the list of approved file types has changed. See the table on this page for approved types.

QuickBooks Online v1704

Date: April 25, 2017

  • Reimbursable charge details are now included on sales Item line types for Invoice objects. Click here for more information. Available with minor version 9.
  • The Customer resource now supports the TaxExemptionReasonId parameter. Available with minor version 10.

QuickBooks Online v1703

Internal, only.

QuickBooks Online v1702

Date: March 9, 2017

  • The field, Item.FullyQualifiedName, is now filterable.
  • New preferences attribute: Preferences.SalesFormsPrefs.EmailCopyToCompany. If set to true, the QuickBooks company is cc'ed on any email sent to customers for sales transactions. Company email used is specified by CompanyInfo.Email.Address.  Available with minor version 8.
  • New preferences attribute: Preferences.SalesFormsPrefs.UsingPriceLevels. If set to true, the QuickBooks company has price levels enabled for sales transactions.
    About price levels.
    • Scheduled to ship with the v1704 release, custom price rules will be available to select QuickBooks companies via the UI, only. The allows the QuickBooks company to establish custom price rules (known as price levels), rather than base pricing, to use on sales forms for any given customer or item. For companies so enabled, creating transactions with base pricing may not be what the user intends. Make sure your app is aware of how Preferences.SalesFormsPrefs.UsingPriceLevels is set so you can warn your users appropriately. Support for price levels in the QuickBooks Online API is not planned.
    • Price Levels FAQs
      • I have customers who are already using my app, how will they be affected because of this new feature? 
        There is no factor if your app pulls pricing data for the intent of read-only purposes.  That is, it reads pricing information from the QuickBooks online company but doesn't actively write it back or set pricing in sales forms.
      • I am developing a new integration with QBO, what code should I add in my app to address this new feature ? 
        Make sure your app is aware of how Preferences.SalesFormsPrefs.UsingPriceLevels is set in the QuickBooks Online company.  For companies so enabled, make sure your users are aware that your app cannot access custom price levels.
      • What happens if I don’t make this change ? Will this corrupt the user’s data?
        Blindly creating sales transactions with base pricing when the QuickBooks Online company has price levels enabled may not be what the user intends and could result in sales transactions that silently have incorrect pricing.
  • Resolved issues
Reference numberEntity 
QBO-34979ItemQueries on Item.FullyQualifiedName are now supported.


ClassClass resource now supports soft delete (Active=false).

QuickBooks Online v1701

Internal, only.

Did you find this page helpful?
Your feedback helps us make our docs better. Please let us know if this page helped you, or if it needs improvement.

 Got Questions? Get Answers in our developer forums.