QuickBooks Tax Classification API

openapi: 3.2.0
info:
  title: QuickBooks Online Accounting Tax Classification API
  version: '2026-11-05'
  description: QuickBooks Online Accounting API (v3). Entities, reports, query, batch and change-data-capture operations for a QuickBooks Online company (realmId). Generated from the JSON Intuit's API Explorer renders; Intuit publishes no OpenAPI document.
  termsOfService: https://developer.intuit.com/app/developer/qbo/docs/legal-agreements/intuit-terms-of-service-for-intuit-developer-services
  contact:
    name: Intuit Developer Support
    url: https://help.developer.intuit.com/s/
  x-generated-from: documentation
  x-generator: convert-intuit-api-explorer.py (deterministic conversion of the provider's API Explorer JSON; no model)
  x-source:
  - https://static.developer.intuit.com/JSONObjects/EntityJsonObject_v1.json
  - https://static.developer.intuit.com/JSONObjects/CodesModelsJsonObjects_v2.json
  - https://static.developer.intuit.com/JSONObjects/TocJsonObject_v1.json
  x-generated: '2026-11-05'
servers:
- url: https://quickbooks.api.intuit.com
  description: Production
- url: https://sandbox-quickbooks.api.intuit.com
  description: Sandbox
security:
- oauth2:
  - com.intuit.quickbooks.accounting
tags:
- name: TaxClassification
  description: Tax classification segregates different items into different classifications and the tax classification is one of the key parameters to determine appropriate tax on transactions involving items. Tax classifications are sourced by either tax governing authorities as in Malaysia or externally like Exactor. 'Fuel', 'Garments' and 'Soft drinks' are a few examples of tax classification in layman terms. User can choose a specific tax classification for an item while creating it.
paths:
  /v3/company/{realmID}/taxclassification/{taxClassificationId}:
    get:
      operationId: readTaxClassification
      summary: Read a taxclassification by ID
      tags:
      - TaxClassification
      x-source: https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/taxclassification
      x-intuit-operation: GET /v3/company/<realmID>/taxclassification/<taxClassificationId>
      description: Retrieves the details of a TaxClassification object that has been previously created.
      parameters:
      - name: realmID
        in: path
        required: true
        schema:
          type: string
      - name: taxClassificationId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Returns the TaxClassification object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/taxclassification'
        '400':
          $ref: '#/components/responses/Fault'
        '401':
          $ref: '#/components/responses/Fault'
        '429':
          $ref: '#/components/responses/Throttled'
      security:
      - oauth2:
        - com.intuit.quickbooks.accounting
  /v3/company/{realmID}/taxclassification/{parentid}/children:
    get:
      operationId: readTaxclassificationByParentID
      summary: Read a taxclassification by Parent ID
      tags:
      - TaxClassification
      x-source: https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/taxclassification
      x-intuit-operation: GET /v3/company/<realmID>/taxclassification/<parentid>/children
      description: Retrieves the details of a TaxClassification object by parent ID.
      parameters:
      - name: realmID
        in: path
        required: true
        schema:
          type: string
      - name: parentid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Returns the TaxClassification object by parent ID.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/taxclassification'
        '400':
          $ref: '#/components/responses/Fault'
        '401':
          $ref: '#/components/responses/Fault'
        '429':
          $ref: '#/components/responses/Throttled'
      security:
      - oauth2:
        - com.intuit.quickbooks.accounting
  /v3/company/{realmID}/taxclassification:
    get:
      operationId: readAllTaxclassifications
      summary: Read all taxclassifications / Read taxclassifications by level
      tags:
      - TaxClassification
      x-source: https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/taxclassification
      x-intuit-operation: GET /v3/company/<realmID>/taxclassification
      description: 'Retrieves the details of all TaxClassification objects that have been previously created.


        **Read taxclassifications by level** (GET /v3/company//taxclassification?level=): Retrieves the details of a TaxClassification object that has been previously created by level.'
      parameters:
      - name: realmID
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Returns all TaxClassification records
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/taxclassification'
        '400':
          $ref: '#/components/responses/Fault'
        '401':
          $ref: '#/components/responses/Fault'
        '429':
          $ref: '#/components/responses/Throttled'
      security:
      - oauth2:
        - com.intuit.quickbooks.accounting
      x-intuit-variants:
      - name: Read taxclassifications by level
        operationId: readTaxclassificationsByLevel
        x-source: https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/taxclassification
        x-intuit-operation: GET /v3/company/<realmID>/taxclassification?level=<level>
        description: Retrieves the details of a TaxClassification object that has been previously created by level.
components:
  schemas:
    referencetype:
      type: object
      title: referencetype
      properties:
        name:
          type: string
          description: An identifying name for the object being referenced by value and is derived from the field that holds the common name of that object. This varies by context and specific type of object referenced. For example, references to a Customer object use Customer.DisplayName to populate this field. Optionally returned in responses, implementation dependent.
          x-intuit-required: Optional
        value:
          type: string
          description: The ID for the referenced object as found in the Id field of the object payload. The context is set by the type of reference and is specific to the QuickBooks company file.
          x-intuit-required: Required
      required:
      - value
    IntuitFault:
      type: object
      properties:
        Fault:
          type: object
          properties:
            type:
              type: string
              enum:
              - ValidationFault
              - SystemFault
              - AuthenticationFault
              - AuthorizationFault
            Error:
              type: array
              items:
                type: object
                properties:
                  code:
                    type: string
                  element:
                    type: string
                  Message:
                    type: string
                  Detail:
                    type: string
        time:
          type: string
          format: date-time
    taxclassification:
      type: object
      title: taxclassification
      properties:
        ApplicableTo:
          type: string
          description: List of item types the tax classification is applicable to. Includes Inventory, NonInventory, Bundle and Service.
          x-intuit-required: Optional
        Code:
          type: string
          description: Code
          x-intuit-required: Optional
        Name:
          type: string
          description: Name of the tax classification
          x-intuit-required: Optional
        Level:
          type: string
          description: Tax classification level (Numeric value 1, or 2. 1 specifies parent tax classification)
        ParentRef:
          allOf:
          - $ref: '#/components/schemas/referencetype'
          description: Reference Type for parent
          x-intuit-required: Required
        Description:
          type: string
          description: Description of the tax classification
          x-intuit-required: Optional
      required:
      - ParentRef
  responses:
    Fault:
      description: Error. The body carries a Fault element (type ValidationFault, SystemFault, AuthenticationFault or AuthorizationFault) with one or more Error entries (code, element, Message, Detail).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/IntuitFault'
    Throttled:
      description: 'HTTP 429: the request was throttled. Wait 60 seconds before retrying.'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/IntuitFault'
  securitySchemes:
    oauth2:
      type: oauth2
      description: 'Intuit OAuth 2.0 (authorization code). Discovery: https://developer.api.intuit.com/.well-known/openid_configuration'
      flows:
        authorizationCode:
          authorizationUrl: https://appcenter.intuit.com/connect/oauth2
          tokenUrl: https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer
          refreshUrl: https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer
          scopes:
            com.intuit.quickbooks.accounting: Grants access to the QuickBooks Online Accounting API, which focuses on accounting data.
            com.intuit.quickbooks.payment: Grants access to the QuickBooks Payments API, which focuses on payments processing.
            openid: Grants access to OpenID Connect features.
            profile: User's given and family names info
            email: User's email address
            phone: User's phone number
            address: User's physical address
x-generated-from: documentation
x-provenance:
  method: generated
  generated: '2026-11-05'
  source: https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/account
  note: Converted from the JSON the developer.intuit.com API Explorer loads (static.developer.intuit.com/JSONObjects). Intuit publishes no OpenAPI document; this is a faithful machine transformation of its own reference data, graded as generated.