---
title: "Retrieve a Calculation's line items"
method: GET
path: "/v1/tax/calculations/{calculation}/line_items"
---

# Retrieve a Calculation's line items

`GET /v1/tax/calculations/{calculation}/line_items`

## Request

- Base URL: `https://api.stripe.com`
- URL: `https://api.stripe.com/v1/tax/calculations/{calculation}/line_items`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Retrieves the line items of a tax calculation as a collection, if the calculation hasn’t expired.

## Path parameters

- `calculation` string, required

## Query parameters

- `ending_before` string
- `expand` string[]
- `limit` integer
- `starting_after` string

## Response `200`

Successful response.

- object
  - `data` TaxCalculationLineItem[], required: Details about each object.
    - `amount` integer, required: The line item amount in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.
    - `amount_tax` integer, required: The amount of tax calculated for this line item, in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units).
    - `id` string, required: Unique identifier for the object.
    - `livemode` boolean, required: If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
    - `metadata` object, nullable: Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
    - `object` 'tax.calculation_line_item', required: String representing the object's type. Objects of the same type share the same value.
    - `performance_location` string, nullable: Indicates the line item represents a performance where the venue location might determine the tax, not the customer address. Leave empty if the tax code doesn't require a tax location. If you provide this value for tax codes with an `optional` location requirement, it overrides the customer address.
    - `product` string, nullable: The ID of an existing [Product](https://docs.stripe.com/api/products/object).
    - `quantity` integer, required: The number of units of the item being purchased. For reversals, this is the quantity reversed.
    - `reference` string, required: A custom identifier for this line item.
    - `tax_behavior` 'exclusive' | 'inclusive', required: Specifies whether the `amount` includes taxes. If `tax_behavior=inclusive`, then the amount includes taxes.
    - `tax_breakdown` TaxProductResourceLineItemTaxBreakdown[], nullable: Detailed account of taxes relevant to this line item.
      - `amount` integer, required: The amount of tax, in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units).
      - `jurisdiction` TaxProductResourceJurisdiction, required
        - `country` string, required: Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
        - `display_name` string, required: A human-readable name for the jurisdiction imposing the tax.
        - `level` 'city' | 'country' | 'county' | 'district' | 'state', required: Indicates the level of the jurisdiction imposing the tax.
        - `state` string, nullable: [ISO 3166-2 subdivision code](https://en.wikipedia.org/wiki/ISO_3166-2), without country prefix. For example, "NY" for New York, United States.
      - `sourcing` 'destination' | 'origin' | 'performance', required: Indicates whether the jurisdiction was determined by the origin (merchant's address) or destination (customer's address).
      - `tax_rate_details` TaxProductResourceLineItemTaxRateDetails
        - `display_name` string, required: A localized display name for tax type, intended to be human-readable. For example, "Local Sales and Use Tax", "Value-added tax (VAT)", or "Umsatzsteuer (USt.)".
        - `percentage_decimal` string, required: The tax rate percentage as a string. For example, 8.5% is represented as "8.5".
        - `tax_type` 'admissions_tax' | 'amusement_tax' | 'attendance_tax' | 'communications_tax' | 'digital_excise_tax' | 'entertainment_tax' | 'gross_receipts_tax' | 'gst' | 'hospitality_tax' | 'hst' | 'igst' | 'jct' | 'lease_tax' | 'luxury_tax' | 'mass_transit_parking_tax' | 'parking_tax' | 'pst' | 'qst' | 'recycling_fee' | 'resort_tax' | 'retail_delivery_fee' | 'rst' | 'sales_tax' | 'service_tax' | 'tourism_tax' | 'utility_users_tax' | 'vat', required: The tax type, such as `vat` or `sales_tax`.
      - `taxability_reason` 'customer_exempt' | 'not_collecting' | 'not_subject_to_tax' | 'not_supported' | 'portion_product_exempt' | 'portion_reduced_rated' | 'portion_standard_rated' | 'product_exempt' | 'product_exempt_holiday' | 'proportionally_rated' | 'reduced_rated' | 'reverse_charge' | 'standard_rated' | 'taxable_basis_reduced' | 'zero_rated', required: The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
      - `taxable_amount` integer, required: The amount on which tax is calculated, in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units).
    - `tax_code` string, required: The [tax code](https://docs.stripe.com/tax/tax-categories) ID used for this resource.
  - `has_more` boolean, required: True if this list has another page of items after this one that can be fetched.
  - `object` 'list', required: String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
  - `url` string, required: The URL where this list can be accessed.

## Other responses

- `default`: Error response.

---

[API](https://skmtc.dev/stainless-api/apis/stripe-api.md) · [All operations](https://skmtc.dev/stainless-api/apis/stripe-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stainless-api/apis/stripe-api/revisions/7cff4cc46d06?raw)