> For the complete documentation index, see [llms.txt](https://docs.digitalriver.com/commerce-api-references/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digitalriver.com/commerce-api-references/commerce-api-reference-guide/shopper-apis-reference/carts.md).

# Carts

The [Carts ](https://www.digitalriver.com/docs/commerce-shopper-api/#tag/Carts)resource in the Commerce Shopper API lets you manage customer shopping experiences. It lets you retrieve, update, and modify a customer's cart. Understanding how to use the Carts resource effectively ensures your users' seamless and efficient shopping process.

The [Carts ](https://www.digitalriver.com/docs/commerce-shopper-api/#tag/Carts)resource provides access to a customer's cart and cart data. Use the Cart resource to get, update, or modify a cart.

{% hint style="danger" %}
**Important**: All methods in this API require an anonymous (limited access) or authenticated (full access) token.
{% endhint %}

<div align="left"><figure><img src="/files/Rgj2ZhybFtSnUC5GZnVM" alt=""><figcaption></figcaption></figure></div>

## Pricing fields

When the value of `taxIncludedPrice` is `true`, the listed price information in the response is tax-inclusive. When the value is `false`, the listed price information in the response is tax exclusive.

* The following fields display prices based on the `taxIncludedPrice` field's value at the line item level.
  * [`listPrice`](/commerce-api-references/commerce-api-reference-guide/glossary.md#list-price)
  * [`listPriceWithQuantity`](/commerce-api-references/commerce-api-reference-guide/glossary.md#list-price-with-quantity)
  * [`salePrice`](/commerce-api-references/commerce-api-reference-guide/glossary.md#sale-price)
  * [`salePriceWithQuantity`](/commerce-api-references/commerce-api-reference-guide/glossary.md#sale-price-with-quantity): This is the total calculated price for the line item with quantity. The sales price with quantity includes:

    * The line item level discount.
    * The Included in Price fee, an invisible fee, is available if you configure it for the line item.
    * If the price list is tax-inclusive, this price will include tax.

    It does not include the following:

    * The order level discount.
    * The "Excluded from price" fee (a visible fee).
    * If the price is tax-exclusive, this price will **not** include tax.
* The following fields display prices based on the `taxIncludedPrice` field's value at the order level.
  * [`Subtotal`](/commerce-api-references/commerce-api-reference-guide/glossary.md#subtotal): sum([`salePriceWithQuantity`](/commerce-api-references/commerce-api-reference-guide/glossary.md#sale-price-with-quantity)) + sum(visible fee)
  * [`subtotalWithDiscount`](/commerce-api-references/commerce-api-reference-guide/glossary.md#subtotal-with-discount)
  * [`discount`](/commerce-api-references/commerce-api-reference-guide/glossary.md#discount)
  * [`shippingAndHandling`](/commerce-api-references/commerce-api-reference-guide/glossary.md#shipping-and-handling)

The following fields are not `taxinclusive`/`exclusive` related. However, they are taxes or include taxes such as [`orderTotal`](/commerce-api-references/commerce-api-reference-guide/glossary.md#order-total):

* At the line item level:
  * [`productTax`](/commerce-api-references/commerce-api-reference-guide/glossary.md#product-tax)
  * [`shippingTax`](/commerce-api-references/commerce-api-reference-guide/glossary.md#shipping-tax)
  * [`feeTax`](/commerce-api-references/commerce-api-reference-guide/glossary.md#fee-tax)
  * [`importTax`](/commerce-api-references/commerce-api-reference-guide/glossary.md#import-tax)
  * [`importDuty`](/commerce-api-references/commerce-api-reference-guide/glossary.md#import-duty)
* At the order level:
  * [`tax`](/commerce-api-references/commerce-api-reference-guide/glossary.md#tax)
  * [`importTaxAndDuty`](/commerce-api-references/commerce-api-reference-guide/glossary.md#import-tax-and-duty)