---
title: "Retrieve a taxation item"
method: GET
path: "/object-query/taxation-items/{key}"
tags: ["Object Queries"]
---

# Retrieve a taxation item

`GET /object-query/taxation-items/{key}`

Retrieve the details of a specific Taxation Item object.

## Path parameters

- `key` string, required

## 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

- 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)