.NET SDK release notes


The .NET SDK is available as open source. The open source code can be found on IntuitDeveloper here. To install the SDK, see Install the .NET SDK.

QuickBooks .NET SDK V5.2

Date: May 31, 2018


  • Added additional minor version support
  • Updated default minor version
  • Fixed an issue when deserializingUnix timestamps
  • Updated OAuth(2)RequestValidator
  • Updated LogPlatformRequests


Added additional minor version support

  • Added support for minor version 24.

Updated default minor version

  • Updated the default minor version to 23.

Fixed issue when deserializingUnix timestamps

  • Fixed issue that occurred when deserializing a Unix timestamp in the case of a 401 error for JSON responses.

Updated OAuth(2)RequestValidator

Updated LogPlatformRequests

  • Updated LogPlatformRequests to allow parallel requests to work with same file. Use FileAccess.ReadWrite in LogPlatformRequests. (See Use FileAccess.ReadWrite.)

QuickBooks .NET SDK V5.0.0

Date: March 5, 2018


  • Support for additional minor versions
  • Support for OAuth migration


Support for additional minor versions

Support for OAuth migration

  • Added support for migration from OAuth 1.0a to OAuth 2.0 (alpha/beta users only).

Resolved issues




SDK-632DataServiceFixed issue that caused the FindAllAsync() method to return an empty list.
SDK-643DataServiceFixed issue that caused the CDCAsync() method to generate an ArgumentException error.

QuickBooks .NET SDK V4.0.0

Date: Aug 7, 2017


  • Upgraded to .NET Framework 4.6.1
  • Updated all dependencies to support .NET Framework 4.6.1


Upgraded to .NET Framework 4.6.1

To support the TLS1.2 protocol, the .NET SDK has been upgraded to support .NET Framework 4.6.1 or above.

Updated all dependencies to support .NET Framework 4.6.1

The following dependencies have been updated:

  • .NET Framework 4.6.1
  • Newtonsoft.Json >=10.0.3
  • DevDefined.OAuth >=0.2

QuickBooks .NET SDK V3.2.1

Date: July 17, 2017


  • Newtonsoft.Json dependency update
  • Minor versions 12 support
  • OAuth 2.0 support


Newtonsoft.Json dependency update

Updated the Newtonsoft.Json dependency (>= 10.0.3).

Minor version 12 support

Added support for minor version 12. Latest XSD: v3 minor version 12

OAuth 2.0 support

The SDK now supports OAuth 2.0 authentication. OAuth 1.0a is still available for existing applications. New applications must implement OAuth 2.0. For more information, see Authorization.


The .NET SDK 3.2.1 requires .NET Framework 4. The OAuth 2.0 SDK 3.2.1 client library requires .NET Framework 4.6.1. To use the OAuth 2.0 SDK client library, your app must use .NET Framework 4.6.1 or above.

QuickBooks .NET SDK V3.1.0

Date: June 20, 2017


  • Newtonsoft.Json dependency update
  • Minor versions 9, 10, and 11 support
  • Resolved issues


Newtonsoft.Json dependency update

Updated the Newtonsoft.Json dependency (>= 10.0.2).

Minor versions 9, 10, and 11 support

Added support for minor versions 9, 10, and 11.


Resolved issues

  • The trace log was updated to expose error details when retry policy is set.
  • The array of errors is now returned in the error response rather than only the top level error.
  • Added a check for missing "/" at the end of the base URL. If inadvertently omitted, the character is appended.

QuickBooks .NET SDK V2.9.1

Date: December 22, 2016


  • QuickBooks Desktop code
  • Resolved issues


QuickBooks Desktop code

Removed deprecated QuickBooks Desktop code.

Resolved issues




SDK-452TaxCodeFixed issue that caused the JSON response for duplicate TaxCode creation using GlobalTaxService to fail due to a deserialization issue.

QuickBooks .NET SDK V2.8.0

Date: November 28, 2016


  • Minor version 8 support
  • cc/bcc field support for Invoice and Preferences entities
  • Updates to the .NET Class Library


Minor version 8

Added support for minor version 8. Latest XSD: V3 minor version 8

cc and bcc fields

Added support for cc and bcc fields in the Invoice and Preferences entities.

Updates to the .NET Class Library

Updated the .NET Class Library to reflect deprecated support for LINQ queries.

QuickBooks .NET SDK V2.7.3

Date: November 1, 2016


  • Updated dependency
  • Added Error Code 429 support
  • Resolved issues


Updated dependency

  • Newtonsoft.Json (>= 9.0.1)

Error Code 429

Added support in preparation for Error Code 429. When this feature is implemented, applications making more than 10 concurrent or multi-threaded API requests to the same realmId will get a 429 response: HTTP/1.1 429 Too Many Requests.

Resolved issues




SDK-54ExceptionUpdated Exception response to include StatusCode and StatusMessage.

QuickBooks .NET SDK V2.6.1

Date: October 7, 2016



Updated dependencies

  • Newtonsoft.Json (>= 8.0.3)
  • DevDefined.OAuth (>= 0.2.0)

New features

Support added for Webhooks helpers using the WebhooksService class.

Minor version 6

Includes all previous minor version items plus the addition of the following:

Resolved Issues




SDK-325ReportServiceFixed space issue with parameters.
SDK-353InvoiceAdded support for voiding an invoice.
SDK-423PaymentsReplaced all workplace.intuit.com URLs with appcenter.intuit.com to resolve Payments app bug.

QuickBooks .NET SDK V2.5.0

Date: May 17, 2016



Minor version 5

Includes all previous minor version items plus, for the France locale, adds support for the following:

Account resource:

  • TxnLocationType attribute, used to define location of an Account object.
  • AccountAlias attribute, used to define a user-friendly account name.

Customer and Vendor resources:

  • include=updateaccountontxns query parameter is supported for Customer and Vendor objects. Use this parameter on Customer and Vendor update endpoints to trigger a ripple update of account information in transactions when Customer.ARAccountRef or Vendor.APAccountRefis updated.

Item resource:

  • include=donotupdateaccountontxns query parameter for Item objects to inhibit updating income or expense account on any existing transactions associated with the Item object.

QuickBooks Online endpoints are now invoked with minorversion=5 by default. For minor version 5, the Type field in the Item entity is required. To avoid this validation, use minor version 3. For information on how to set the minor version, see Configuration.

Resolved issues




SDK-304BillPaymentSerialization and deserialization generated an error for BillPayment transactions.

QuickBooks .NET SDK V2.4.0

Date: September 28, 2015



Minor version 3

Includes all minor version 1 and minor version 2 items, 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.

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.
  • Account.TaxCodeRef attribute to specify the default tax code used for the account—available for global locales, only.

QuickBooks Online endpoints are now invoked with minorversion=3 by default. See Configuration for more information.

Minor version 4

Includes all minor version 1, minor version 2, and minor version 3 items, plus the addition of the following:

In support of enhanced inventory, the following are added to the Item resource:

  • Item.Sku attribute.
  • NonInventory to list of valid Item.Type selections.

XSD: V3 minor version 4

The SDK comes preconfigured to use minor version 3. In order to take advantage of these features, you can either specify minor version 4 in the service context:

ServiceContext serviceContext = Initializer.InitializeServiceContextQbo();
serviceContext.IppConfiguration.MinorVersion.Qbo = "4";

or manually configure the SDK for minor version 4:

                <!— ... other settings appear here  ... —>
                <minorVersion qbo=4></minorVersion>
            <!— ... oAuth tokens etc  ... —>

Resolved issues


QuickBooks .NET SDK V2.3.0

Date: July 30 2015



New entity features

Minor version 2

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.

Transaction entities:

  • Transaction tax type as defined in company setting is now used instead of always defaulting toExclusive.
    Note: This change is only applicable to global companies.

QuickBooks Online endpoints are now invoked with minorversion=2. See Configuration for more information.

Resolved issues




SDK-3AttachableUsers were unable to attach a note to an invoice using the Attachable entity.
SDK-7QueryAn issue pertaining to LINQ queries would result in a query failure.

QuickBooks .NET SDK V2.2.0

Date: December 15 2014


  • Reports Support Added—for current report support, click here.
  • Entity Support Added—for current entity support, click here.


Reports support added

  • Reports Added:
    • AP Aging Summary
    • AR Aging Summary
    • Balance Sheet
    • Business Activity Statement
    • Statement of Cash Flow
    • Sales by Class
    • Customer Balance
    • Customer Income
    • Sales by Customer
    • Sales by Department
    • Inventory Valuation Summary
    • Sales by Product
    • Profit and Loss
    • Trial Balance
    • Vendor Balance
    • Expenses by Vendor
    • Profit and Loss Detail
    • Customer Balance Detail
    • AR Aging Detail
    • AP Aging Detail
    • Vendor Balance Detail
    • General Ledger Detail
    • Account List
    • Transaction List
  • Added Previous Period and Year Comparison columns to Summary Reports.

Entity support added

  • Entities added:
    • Budget
    • TaxService
    • TaxAgency
    • RefundReceipt
    • Transfer
    • Linked Transactions
  • Four new subscription-related attributes added to CompanyInfo:
    • OfferingSku
    • SubscriptionStatus
    • PayrollFeature
    • AccountantFeature

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.