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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digitalriver.com/commerce-api-references/commerce-api-reference-guide/shopper-apis-reference/carts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.