---
title: Sale - Customer API
description: |-
  A record of an individual sale associated with a sales agreement. Every monetary value in an order's sales data is represented in the smallest unit of the currency.
  When amounts are divided across multiple line items, such as taxes or order discounts, the amounts might not divide evenly across all of the line items on the order.
  To address this, the remaining currency units that couldn't be divided evenly are allocated one at a time, starting with the first line item, until they are all accounted for.
  In aggregate, the values sum up correctly. In isolation, one line item might have a different tax or discount amount than another line item of the same price, before taxes and discounts.
  This is because the amount could not be divided evenly across the items. The allocation of currency units across line items is immutable. After they are allocated, currency units are never reallocated or redistributed among the line items.
api_version: 2025-10
api_name: customer
type: interface
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/customer/latest/interfaces/sale
  md: https://shopify.dev/docs/api/customer/latest/interfaces/sale.md
---

# Sale

interface

A record of an individual sale associated with a sales agreement. Every monetary value in an order's sales data is represented in the smallest unit of the currency. When amounts are divided across multiple line items, such as taxes or order discounts, the amounts might not divide evenly across all of the line items on the order. To address this, the remaining currency units that couldn't be divided evenly are allocated one at a time, starting with the first line item, until they are all accounted for. In aggregate, the values sum up correctly. In isolation, one line item might have a different tax or discount amount than another line item of the same price, before taxes and discounts. This is because the amount could not be divided evenly across the items. The allocation of currency units across line items is immutable. After they are allocated, currency units are never reallocated or redistributed among the line items.

## Fields

* action​Type

  [Sale​Action​Type!](https://shopify.dev/docs/api/customer/latest/enums/SaleActionType)

  non-null

  The type of order action represented by the sale.

* id

  [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID)

  non-null

  The unique ID of the sale.

* line​Type

  [Sale​Line​Type!](https://shopify.dev/docs/api/customer/latest/enums/SaleLineType)

  non-null

  The type of line associated with the sale.

* quantity

  [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int)

  The number of units ordered or intended to be returned.

* taxes

  [\[Sale​Tax!\]!](https://shopify.dev/docs/api/customer/latest/objects/SaleTax)

  non-null

  The individual taxes associated with the sale.

* total​Amount

  [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

  non-null

  The total sale amount after taxes and discounts.

* total​Discount​Amount​After​Taxes

  [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

  non-null

  The total amount of discounts allocated to the sale after taxes.

* total​Discount​Amount​Before​Taxes

  [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

  non-null

  The total discounts allocated to the sale before taxes.

* total​Tax​Amount

  [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

  non-null

  The total tax amount for the sale.

***

## Types implemented in

* [Additional​Fee​Sale](https://shopify.dev/docs/api/customer/latest/objects/AdditionalFeeSale)

  OBJECT

  A sale that includes an additional fee charge.

  * action​Type

    [Sale​Action​Type!](https://shopify.dev/docs/api/customer/latest/enums/SaleActionType)

    non-null

    The type of order action represented by the sale.

  * id

    [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID)

    non-null

    The unique ID of the sale.

  * line​Type

    [Sale​Line​Type!](https://shopify.dev/docs/api/customer/latest/enums/SaleLineType)

    non-null

    The type of line associated with the sale.

  * quantity

    [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int)

    The number of units ordered or intended to be returned.

  * taxes

    [\[Sale​Tax!\]!](https://shopify.dev/docs/api/customer/latest/objects/SaleTax)

    non-null

    The individual taxes associated with the sale.

  * total​Amount

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total sale amount after taxes and discounts.

  * total​Discount​Amount​After​Taxes

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total amount of discounts allocated to the sale after taxes.

  * total​Discount​Amount​Before​Taxes

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total discounts allocated to the sale before taxes.

  * total​Tax​Amount

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total tax amount for the sale.

* [Adjustment​Sale](https://shopify.dev/docs/api/customer/latest/objects/AdjustmentSale)

  OBJECT

  A sale event that results in an adjustment to the order price.

  * action​Type

    [Sale​Action​Type!](https://shopify.dev/docs/api/customer/latest/enums/SaleActionType)

    non-null

    The type of order action represented by the sale.

  * id

    [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID)

    non-null

    The unique ID of the sale.

  * line​Type

    [Sale​Line​Type!](https://shopify.dev/docs/api/customer/latest/enums/SaleLineType)

    non-null

    The type of line associated with the sale.

  * quantity

    [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int)

    The number of units ordered or intended to be returned.

  * taxes

    [\[Sale​Tax!\]!](https://shopify.dev/docs/api/customer/latest/objects/SaleTax)

    non-null

    The individual taxes associated with the sale.

  * total​Amount

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total sale amount after taxes and discounts.

  * total​Discount​Amount​After​Taxes

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total amount of discounts allocated to the sale after taxes.

  * total​Discount​Amount​Before​Taxes

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total discounts allocated to the sale before taxes.

  * total​Tax​Amount

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total tax amount for the sale.

* [Duty​Sale](https://shopify.dev/docs/api/customer/latest/objects/DutySale)

  OBJECT

  A sale that includes a duty charge.

  * action​Type

    [Sale​Action​Type!](https://shopify.dev/docs/api/customer/latest/enums/SaleActionType)

    non-null

    The type of order action represented by the sale.

  * id

    [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID)

    non-null

    The unique ID of the sale.

  * line​Type

    [Sale​Line​Type!](https://shopify.dev/docs/api/customer/latest/enums/SaleLineType)

    non-null

    The type of line associated with the sale.

  * quantity

    [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int)

    The number of units ordered or intended to be returned.

  * taxes

    [\[Sale​Tax!\]!](https://shopify.dev/docs/api/customer/latest/objects/SaleTax)

    non-null

    The individual taxes associated with the sale.

  * total​Amount

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total sale amount after taxes and discounts.

  * total​Discount​Amount​After​Taxes

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total amount of discounts allocated to the sale after taxes.

  * total​Discount​Amount​Before​Taxes

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total discounts allocated to the sale before taxes.

  * total​Tax​Amount

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total tax amount for the sale.

* [Fee​Sale](https://shopify.dev/docs/api/customer/latest/objects/FeeSale)

  OBJECT

  A sale associated with a fee.

  * action​Type

    [Sale​Action​Type!](https://shopify.dev/docs/api/customer/latest/enums/SaleActionType)

    non-null

    The type of order action represented by the sale.

  * id

    [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID)

    non-null

    The unique ID of the sale.

  * line​Type

    [Sale​Line​Type!](https://shopify.dev/docs/api/customer/latest/enums/SaleLineType)

    non-null

    The type of line associated with the sale.

  * quantity

    [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int)

    The number of units ordered or intended to be returned.

  * taxes

    [\[Sale​Tax!\]!](https://shopify.dev/docs/api/customer/latest/objects/SaleTax)

    non-null

    The individual taxes associated with the sale.

  * total​Amount

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total sale amount after taxes and discounts.

  * total​Discount​Amount​After​Taxes

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total amount of discounts allocated to the sale after taxes.

  * total​Discount​Amount​Before​Taxes

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total discounts allocated to the sale before taxes.

  * total​Tax​Amount

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total tax amount for the sale.

* [Gift​Card​Sale](https://shopify.dev/docs/api/customer/latest/objects/GiftCardSale)

  OBJECT

  A sale associated with a gift card.

  * action​Type

    [Sale​Action​Type!](https://shopify.dev/docs/api/customer/latest/enums/SaleActionType)

    non-null

    The type of order action represented by the sale.

  * id

    [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID)

    non-null

    The unique ID of the sale.

  * line​Item

    [Line​Item!](https://shopify.dev/docs/api/customer/latest/objects/LineItem)

    non-null

    The line item associated with the sale.

  * line​Type

    [Sale​Line​Type!](https://shopify.dev/docs/api/customer/latest/enums/SaleLineType)

    non-null

    The type of line associated with the sale.

  * quantity

    [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int)

    The number of units ordered or intended to be returned.

  * taxes

    [\[Sale​Tax!\]!](https://shopify.dev/docs/api/customer/latest/objects/SaleTax)

    non-null

    The individual taxes associated with the sale.

  * total​Amount

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total sale amount after taxes and discounts.

  * total​Discount​Amount​After​Taxes

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total amount of discounts allocated to the sale after taxes.

  * total​Discount​Amount​Before​Taxes

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total discounts allocated to the sale before taxes.

  * total​Tax​Amount

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total tax amount for the sale.

* [Product​Sale](https://shopify.dev/docs/api/customer/latest/objects/ProductSale)

  OBJECT

  A sale associated with a product.

  * action​Type

    [Sale​Action​Type!](https://shopify.dev/docs/api/customer/latest/enums/SaleActionType)

    non-null

    The type of order action represented by the sale.

  * id

    [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID)

    non-null

    The unique ID of the sale.

  * line​Item

    [Line​Item!](https://shopify.dev/docs/api/customer/latest/objects/LineItem)

    non-null

    The line item for the associated sale.

  * line​Type

    [Sale​Line​Type!](https://shopify.dev/docs/api/customer/latest/enums/SaleLineType)

    non-null

    The type of line associated with the sale.

  * quantity

    [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int)

    The number of units ordered or intended to be returned.

  * taxes

    [\[Sale​Tax!\]!](https://shopify.dev/docs/api/customer/latest/objects/SaleTax)

    non-null

    The individual taxes associated with the sale.

  * total​Amount

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total sale amount after taxes and discounts.

  * total​Discount​Amount​After​Taxes

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total amount of discounts allocated to the sale after taxes.

  * total​Discount​Amount​Before​Taxes

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total discounts allocated to the sale before taxes.

  * total​Tax​Amount

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total tax amount for the sale.

* [Shipping​Line​Sale](https://shopify.dev/docs/api/customer/latest/objects/ShippingLineSale)

  OBJECT

  A sale associated with a shipping charge.

  * action​Type

    [Sale​Action​Type!](https://shopify.dev/docs/api/customer/latest/enums/SaleActionType)

    non-null

    The type of order action represented by the sale.

  * id

    [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID)

    non-null

    The unique ID of the sale.

  * line​Type

    [Sale​Line​Type!](https://shopify.dev/docs/api/customer/latest/enums/SaleLineType)

    non-null

    The type of line associated with the sale.

  * quantity

    [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int)

    The number of units ordered or intended to be returned.

  * taxes

    [\[Sale​Tax!\]!](https://shopify.dev/docs/api/customer/latest/objects/SaleTax)

    non-null

    The individual taxes associated with the sale.

  * total​Amount

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total sale amount after taxes and discounts.

  * total​Discount​Amount​After​Taxes

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total amount of discounts allocated to the sale after taxes.

  * total​Discount​Amount​Before​Taxes

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total discounts allocated to the sale before taxes.

  * total​Tax​Amount

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total tax amount for the sale.

* [Tip​Sale](https://shopify.dev/docs/api/customer/latest/objects/TipSale)

  OBJECT

  A sale that is associated with a tip.

  * action​Type

    [Sale​Action​Type!](https://shopify.dev/docs/api/customer/latest/enums/SaleActionType)

    non-null

    The type of order action represented by the sale.

  * id

    [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID)

    non-null

    The unique ID of the sale.

  * line​Item

    [Line​Item!](https://shopify.dev/docs/api/customer/latest/objects/LineItem)

    non-null

    The line item associated with the sale.

  * line​Type

    [Sale​Line​Type!](https://shopify.dev/docs/api/customer/latest/enums/SaleLineType)

    non-null

    The type of line associated with the sale.

  * quantity

    [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int)

    The number of units ordered or intended to be returned.

  * taxes

    [\[Sale​Tax!\]!](https://shopify.dev/docs/api/customer/latest/objects/SaleTax)

    non-null

    The individual taxes associated with the sale.

  * total​Amount

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total sale amount after taxes and discounts.

  * total​Discount​Amount​After​Taxes

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total amount of discounts allocated to the sale after taxes.

  * total​Discount​Amount​Before​Taxes

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total discounts allocated to the sale before taxes.

  * total​Tax​Amount

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total tax amount for the sale.

* [Unknown​Sale](https://shopify.dev/docs/api/customer/latest/objects/UnknownSale)

  OBJECT

  This represents new sale types that have been added in future API versions. You may update to a more recent API version to receive additional details about this sale.

  * action​Type

    [Sale​Action​Type!](https://shopify.dev/docs/api/customer/latest/enums/SaleActionType)

    non-null

    The type of order action represented by the sale.

  * id

    [ID!](https://shopify.dev/docs/api/customer/latest/scalars/ID)

    non-null

    The unique ID of the sale.

  * line​Type

    [Sale​Line​Type!](https://shopify.dev/docs/api/customer/latest/enums/SaleLineType)

    non-null

    The line type assocated with the sale.

  * quantity

    [Int](https://shopify.dev/docs/api/customer/latest/scalars/Int)

    The number of units ordered or intended to be returned.

  * taxes

    [\[Sale​Tax!\]!](https://shopify.dev/docs/api/customer/latest/objects/SaleTax)

    non-null

    The individual taxes associated with the sale.

  * total​Amount

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total sale amount after taxes and discounts.

  * total​Discount​Amount​After​Taxes

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total amount of discounts allocated to the sale after taxes.

  * total​Discount​Amount​Before​Taxes

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total discounts allocated to the sale before taxes.

  * total​Tax​Amount

    [Money​V2!](https://shopify.dev/docs/api/customer/latest/objects/MoneyV2)

    non-null

    The total tax amount for the sale.

***

```json
{
	"actionType": "",
	"id": "",
	"lineType": "",
	"quantity": "",
	"taxes": "",
	"totalAmount": "",
	"totalDiscountAmountAfterTaxes": "",
	"totalDiscountAmountBeforeTaxes": "",
	"totalTaxAmount": ""
}
```