Stay up to date

Developer changelog

API

Duties are now available on the Storefront API

Effective November 20, 2020

New

Duties are now available on the 2021-01 version of the Storefront API. You can query duties on the Checkout and Order resources.

Learn more by visiting the Checkout and Order resource reference docs.

Details of resources affected:

API Version 2021-01 or later (includes duties)

Checkout

lineItemsSubtotalPrice: The sum of all the prices of all the items in the checkout. Duties, taxes, shipping and discounts excluded.

paymentDueV2: The amount left to be paid. This is equal to the cost of the line items, duties, taxes and shipping minus discounts and gift cards.

subtotalPriceV2: Price of the checkout before duties, shipping and taxes.

totalPriceV2: The sum of all the prices of all the items in the checkout, duties, taxes and discounts included.

Order

currentSubtotalPrice: The subtotal of line items and their discounts, excluding line items that have been removed. Does not contain order-level discounts, duties, shipping costs, or shipping discounts. Taxes are not included unless the order is a taxes-included order.

currentTotalPrice: The total amount of the order, including duties, taxes and discounts, minus amounts for line items that have been removed.

subtotalPriceV2: Price of the order before duties, shipping and taxes.

totalPriceV2: The sum of all the prices of all the items in the order, duties, taxes and discounts included (must be positive).

API Version 2020-10 or earlier (does not include duties)

Checkout

lineItemsSubtotalPrice: The sum of all the prices of all the items in the checkout. Taxes, shipping and discounts excluded.

paymentDueV2: The amount left to be paid. This is equal to the cost of the line items, taxes and shipping minus discounts and gift cards.

subtotalPriceV2: Price of the checkout before shipping and taxes.

totalPriceV2: The sum of all the prices of all the items in the checkout, taxes and discounts included.

Order

currentSubtotalPrice: The subtotal of line items and their discounts, excluding line items that have been removed. Does not contain order-level discounts, shipping costs, or shipping discounts. Taxes are not included unless the order is a taxes-included order.

currentTotalPrice: The total amount of the order, including taxes and discounts, minus amounts for line items that have been removed.

subtotalPriceV2: Price of the order before shipping and taxes.

totalPriceV2: The sum of all the prices of all the items in the order, taxes and discounts included (must be positive).