---
title: "List taxation items"
method: GET
path: "/object-query/taxation-items"
tags: ["Object Queries"]
---

# List taxation items

`GET /object-query/taxation-items`

Lists Taxation Item objects. You can use the query parameters to filter, expand, and sort the returned results.

## Query parameters

- `pageSize` integer
- `cursor` string
- `sort[]` string[]
- `expand[]` string[]
- `filter[]` string[]
- `fields[]` string[]
- `includeNullFields` boolean

## Headers

- `Idempotency-Key` string
- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Response `200`

OK

- object
  - `nextPage` string, nullable — A string that can be used as the `cursor` value to retrieve the next page of the response if it exists; otherwise absent.
  - `data` ExpandedTaxationItem[]
    - `id` string — The unique identifier of the taxation item.
    - `createdById` string — The unique identifier of the user who created the taxation item.
    - `createdDate` string, date-time — The date and time when the taxation item was created in the Zuora system, in the `yyyy-mm-dd hh:mm:ss` format.
    - `updatedById` string — The unique identifier of the user who last updated the taxation item.
    - `updatedDate` string, date-time — The date and time when the taxation item was last updated, in the `yyyy-mm-dd hh:mm:ss` format.
    - `creditAmount` number, double — The amount of credit memos applied to the taxation item.
    - `accountingCode` string — The accounting code that maps to the taxation item in your accounting system.
    - `exemptAmount` number, double — The calculated tax amount excluded due to the exemption.
    - `invoiceItemId` string — The unique identifier of the invoice item to which the taxation item belongs.
    - `jurisdiction` string — The jurisdiction that applies the tax or VAT. This value is typically a state, province, county, or city.
    - `locationCode` string — The identifier for the location based on the value of the `taxCode` field.
    - `name` string — The name of the taxation item.
    - `paymentAmount` number, double — The amount of payment applied to the invoice or debit memo.
    - `taxAmount` number, double — The amount of the tax applied to the billing document.
    - `taxAmountUnrounded` number — The amount of the tax applied to the billing document before rounding.
    - `countryCode` string — The code of country to which the taxation item.
    - `taxCodeDescription` string — The description of the tax code.
    - `customerCode` string — The customer code. This field is only available if you are using one of the Vertex Tax Connector apps.
    - `exemptCertificate` string — The tax exemption certificate that the customer holds. Applicable if you use Zuora Tax or Connect tax engines.
    - `sellerRegistration` string — Your seller registration code. This field is only available if you are using the OneSource Determination app.
    - `taxDescription` string — The description of the tax.
    - `taxRuleId` string — The unique identifier of the tax rule.
    - `taxCode` string — The tax code identifies which tax rules and tax rates to apply to a specific billing document.
    - `taxMode` 'TaxExclusive' | 'TaxInclusive' — The mode of the tax.
    - `taxDate` string, date — The date when the tax is applied to the billing document.
    - `taxRate` number, double — The tax rate applied to the billing document.
    - `taxRateDescription` string — The description of the tax rate.
    - `taxRateType` 'Percentage' | 'FlatFee' — The type of the tax rate applied to the billing document.
    - `balance` number — The remaining balance on the taxation item.
    - `journalEntryId` string — The ID of the journal entry that corresponds to this transaction.
    - `salesTaxPayableAccountingCodeId` string — The accounting code for Sales Tax Payable.
    - `accountReceivableAccountingCodeId` string — The accounting code for Account Receivable.
    - `taxableItemSnapshotId` string — The unique identifier of the taxable item snapshot.
    - `periodEndDate` string, date — The end date of the period to which the taxation item belongs.
    - `periodStartDate` string, date — The start date of the period to which the taxation item belongs.
    - `taxableAmount` number, double — The taxable amount of the taxation item.

## Other responses

- `500` — Internal server error
- `4XX` — Invalid input

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)