---
title: "List all items of an invoice"
method: GET
path: "/v1/invoices/{invoiceKey}/items"
tags: ["Invoices"]
---

# List all items of an invoice

`GET /v1/invoices/{invoiceKey}/items`

Retrieves the information about all items of a specified invoice.

## Path parameters

- `invoiceKey` string, required

## Query parameters

- `pageSize` integer
- `page` integer

## Headers

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

## Response `200`

OK

- GETInvoiceItemsResponse
  - `invoiceItems` InvoiceItem[] — Container for invoice items.
    - `accountingCode` string — The accounting code associated with the invoice item.
    - `adjustmentLiabilityAccountingCode` string — The accounting code for adjustment liability. **Note**: This field is only available if you have the Billing - Revenue Integration feature enabled.
    - `adjustmentRevenueAccountingCode` string — The accounting code for adjustment revenue. **Note**: This field is only available if you have the Billing - Revenue Integration feature enabled.
    - `appliedToItemId` string, nullable — The unique ID of the invoice item that the discount charge is applied to.
    - `availableToCreditAmount` number — The amount of the invoice item that is available to credit.
    - `balance` string, decimal — The balance of the invoice item. **Note**: This field is only available if you have the Invoice Settlement feature enabled.
    - `bookingReference` string — The booking reference of the invoice item.
    - `chargeAmount` string, decimal — The amount of the charge. **Note**: This amount does not include taxes regardless if the charge's tax mode is inclusive or exclusive. This is the discount amount actually applied when the invoice item is a discount charge.
    - `chargeDate` string — The date when the invoice item is charged, in `yyyy-mm-dd hh:mm:ss` format.
    - `chargeDescription` string — The description of the charge.
    - `chargeId` string — The unique ID of the charge.
    - `chargeName` string — The name of the charge.
    - `chargeType` 'OneTime' | 'Recurring' | 'Usage' — The type of the charge.
    - `commitmentId` string — The ID of the commitment.
    - `commitmentPeriodId` string — The ID of the commitment period.
    - `contractAssetAccountingCode` string — The accounting code for contract asset. **Note**: This field is only available if you have the Billing - Revenue Integration feature enabled.
    - `contractLiabilityAccountingCode` string — The accounting code for contract liability. **Note**: This field is only available if you have the Billing - Revenue Integration feature enabled.
    - `contractRecognizedRevenueAccountingCode` string — The accounting code for contract recognized revenue. **Note**: This field is only available if you have the Billing - Revenue Integration feature enabled.
    - `deferredRevenueAccountingCode` string — The deferred revenue accounting code associated with the invoice item. **Note:** This field is only available if you have Zuora Finance enabled.
    - `description` string — The description of the invoice item.
    - `excludeItemBillingFromRevenueAccounting` boolean — The flag to exclude the invoice item from revenue accounting. **Note**: This field is only available if you have the Billing - Revenue Integration feature enabled.
    - `fulfillmentId` string — The reference ID of the fulfillment associated with the invoice item.
    - `id` string — Item ID.
    - `invoiceScheduleId` string — The ID of the invoice schedule item by which Invoice Schedule Item the invoice item is generated by when the Invoice Schedule Item is executed. **Note**: This field is available only if you have the <a href="https://docs.zuora.com?resourceId=billing-billing-schedule-overview" target="_blank">Billing Schedule</a> feature enabled.
    - `invoiceScheduleItemId` string — The ID of the invoice schedule item associated with the invoice item. **Note**: This field is available only if you have the <a href="https://docs.zuora.com?resourceId=billing-billing-schedule-overview" target="_blank">Billing Schedule</a> feature enabled.
    - `itemType` string — The type of the invoice item.
    - `numberOfDeliveries` number — The number of deliveries dedicated to the Delivery Pricing charges. **Note**: This field is available only if you have the Delivery Pricing feature enabled.
    - `orderLineItemId` string — The reference ID of the oder line item associated with the invoice item.
    - `processingType` 'Charge' | 'Discount' | 'Prepayment' | 'Tax' | 'Rounding' — The kind of the charge for the invoice item.
    - `productName` string — Name of the product associated with this item.
    - `productRatePlanChargeId` string — The ID of the product rate plan charge that the invoice item is created from.
    - `purchaseOrderNumber` string — The purchase order number associated with the invoice item.
    - `quantity` string, decimal — The quantity of this item, in the configured unit of measure for the charge.
    - `reflectDiscountInNetAmount` boolean — When you apply percentage discounts to either of the following charges, you need to set the `reflectDiscountInNetAmount` field on your discount charge to `true`, to enable calculating and displaying the net amount of the following charges in Zuora Revenue. * delivery pricing charge * prepayment charge * drawdown charge Note the following: * If you are an <a href="https://docs.zuora.com/en/zuora-billing/set-up-zuora-billing/enable-order-to-revenue/overview-of-order-to-revenue" target="_blank">Order to Revenue</a> customer, when you set the `reflectDiscountInNetAmount` field to `true`, you must also set both the `excludeItemBookingFromRevenueAccounting` and `ExcludeItemBillingFromRevenueAccounting` fields to `true`. * If you are a <a href="https://docs.zuora.com?resourceId=revenue-billing-integration" target="_blank">Billing - Revenue Integration</a> customer, you must set the `reflectDiscountInNetAmount` field to `false`, otherwise an error will be returned. Billing - Revenue Integration does not support discounts on the preceding charges. * If you are a Zuora Billing customer who does not enable the Order to Revenue or Billing - Revenue Integration feature, when you apply percentage discounts to the preceding charges, you also need to set the `reflectDiscountInNetAmount` field to `true`.
    - `recognizedRevenueAccountingCode` string — The recognized revenue accounting code associated with the invoice item. **Note:** This field is only available if you have Zuora Finance enabled.
    - `revRecCode` string — The revenue recognition code.
    - `revRecTriggerCondition` 'ContractEffectiveDate' | 'ServiceActivationDate' | 'CustomerAcceptanceDate' — The date when revenue recognition is triggered.
    - `revenueRecognitionRuleName` string — The revenue recognition rule of the invoice item. **Note:** This field is only available if you have Zuora Finance enabled.
    - `serviceEndDate` string, date — The end date of the service period for this item, i.e., the last day of the service period, as _yyyy-mm-dd_.
    - `serviceStartDate` string, date — The start date of the service period for this item, as _yyyy-mm-dd_. For a one-time fee item, the date of the charge.
    - `sku` string — The SKU of the invoice item.
    - `shipToContactId` string — The ID of the ship-to contact associated with the invoice item.
    - `soldToContactId` string — The ID of the sold-to contact associated with the invoice item. **Note**: If you have the Flexible Billing Attributes feature disabled, the value of this field is `null`.
    - `soldToContactSnapshotId` string — The ID of the sold-to contact snapshot associated with the invoice item. **Note**: If you have the Flexible Billing Attributes feature disabled, the value of this field is `null`.
    - `sourceItemType` 'SubscriptionComponent' | 'Rounding' | 'ProductRatePlanCharge' | 'None' | 'OrderLineItem' — The type of the source item.
    - `subscriptionId` string — The ID of the subscription for this item.
    - `subscriptionName` string — The name of the subscription for this item.
    - `taxAmount` string, decimal — Tax applied to the charge.
    - `taxCode` string — The tax code of the invoice item. **Note** Only when taxation feature is enabled, this field can be presented.
    - `taxMode` string — The tax mode of the invoice item. **Note** Only when taxation feature is enabled, this field can be presented.
    - `taxationItems` object — Container for the taxation items of the invoice item.
      - `data` GETInvoiceTaxItemType[] — List of taxation items.
        - `availableToCreditAmount` number — The amount of the invoice taxation item that is available to credit.
        - `applicableTaxUnRounded` number — The unrounded amount of the tax.
        - `country` string — The field which contains country code.
        - `balance` number, double — The balance of the taxation item.
        - `creditAmount` number, double — The amount of credit memos applied to the taxation item.
        - `exemptAmount` number, double — The calculated tax amount excluded due to the exemption.
        - `id` string — The ID of the taxation item.
        - `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 payments applied to the taxation item.
        - `taxAmount` number, double — The amount of taxation.
        - `taxCode` string — The tax code identifies which tax rules and tax rates to apply to a specific invoice.
        - `taxCodeDescription` string, nullable — The description of the tax code.
        - `taxDate` string, date — The date that the tax is applied to the invoice, in `yyyy-mm-dd` format.
        - `taxRate` number, double — The tax rate applied to the invoice.
        - `taxRateDescription` string — The description of the tax rate.
        - `taxRateType` 'Percentage' | 'FlatFee' — The type of the tax rate.
      - `nextPage` string, URL — URL to retrieve the next page of the response if it exists; otherwise absent.
    - `unbilledReceivablesAccountingCode` string — The accounting code for unbilled receivables. **Note**: This field is only available if you have the Billing - Revenue Integration feature enabled.
    - `unitOfMeasure` string — Unit used to measure consumption.
    - `unitPrice` number, double — The per-unit price of the invoice item. **Note**: For discount charges, this represents the discount percentage (for percentage-based discounts) or the discount amount (for fixed-amount discounts).
    - `IntegrationId__NS` string — ID of the corresponding object in NetSuite. Only available if you have installed the [Zuora Connector for NetSuite](https://www.zuora.com/connect/app/?appId=265).
    - `IntegrationStatus__NS` string — Status of the invoice item's synchronization with NetSuite. Only available if you have installed the [Zuora Connector for NetSuite](https://www.zuora.com/connect/app/?appId=265).
    - `SyncDate__NS` string — Date when the invoice item was synchronized with NetSuite. Only available if you have installed the [Zuora Connector for NetSuite](https://www.zuora.com/connect/app/?appId=265).
  - `nextPage` string, URL — URL to retrieve the next page of the response if it exists; otherwise absent.
  - `success` boolean — Returns `true` if the request was processed successfully.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

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