QuickBooks: Read a taxcode — response body — Tax Code

API reference · Contract 2026-10-20

SDK schema: Read a taxcode — response body — Tax Code

Field	Type	Presence	Description and constraints
$	object	Root	Additional keys: allowed
Active	JSON	Optional	False if inactive. Inactive sales tax codes may be hidden from display and may not be used on financial transactions.
Active (anyOf 1)	boolean	Alternative
Active (anyOf 2)	string	Alternative	Known values: true, false
Description	string	Optional	User entered description for the sales tax code.
Hidden	JSON	Optional	Read-only. Denotes whether active tax codes are displayed on transactions. true —-This tax code is hidden on transactions. false —-This tax code is displayed on transactions. Read only: true
Hidden (anyOf 1)	boolean	Alternative
Hidden (anyOf 2)	string	Alternative	Known values: true, false
Id	string	Optional	Unique identifier for this object. Read only: true
MetaData	Model	Optional	Expand Read a bill — response body — Bill Meta Data Descriptive information about the object. The MetaData values are set by Data Services and are read only for all applications.
Name	string	Optional	User recognizable name for the tax sales code.
PurchaseTaxRateList	Model	Optional	Expand Read a taxcode — response body — Tax Code Sales Tax Rate List List of references to tax rates that apply for purchase transactions when this tax code represents a group of tax rates. Required when TaxGroup is set to true Conditionally required
SalesTaxRateList	Model	Optional	Expand Read a taxcode — response body — Tax Code Sales Tax Rate List List of references to tax rates that apply for sales transactions when this tax code represents a group of tax rates. Required when TaxGroup is set to true Conditionally required
SyncToken	string	Optional	Version number of the object. It is used to lock an object for use by one app at a time. As soon as an application modifies an object, its SyncToken is incremented. Attempts to modify an object specifying an older SyncToken fails. Only the latest version of the object is maintained by QuickBooks Online. Read only: true
TaxCodeConfigType	string	Optional	Flag to identify whether the TaxCode is system defined by Automated Sales Tax engine or user generated. Valid values include USER_DEFINED , SYSTEM_GENERATED SYSTEM_GENERATED. Read only: true
TaxGroup	JSON	Optional	true —-this object represents a group of one or more tax rates. false —-this object represents pseudo-tax codes TAX and NON. Read only: true
TaxGroup (anyOf 1)	boolean	Alternative
TaxGroup (anyOf 2)	string	Alternative	Known values: true, false
Taxable	JSON	Optional	False or null means meaning non-taxable. True means taxable. Always true, except for the pseudo taxcode NON. Read only: true
Taxable (anyOf 1)	boolean	Alternative
Taxable (anyOf 2)	string	Alternative	Known values: true, false

Referenced models: Read a bill — response body — Bill Meta Data, Read a taxcode — response body — Tax Code Sales Tax Rate List