The [MIME type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) of the response body.

Accept

cartId

The [MIME type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) of the request body.

Content-Type

To return product options add one of the following include:

`lineItems.physicalItems.options`: The Cart returns an abbreviated result. Use this to return physical items product options. Can also be used in a /POST to have the extended Cart object return.

`lineItems.digitalItems.options`:  The Cart returns an abbreviated result. Use this to return digital items product options.  Can also be used in a /POST to have the extended Cart object return.

`lineItems.digitalItems.options,lineItems.physicalItems.options`:  The Cart returns an abbreviated result. Use this to return digital and physical options. Can also be used in a /POST to have the extended Cart object return.

include

itemId

The request cannot be processed due to a possible conflict. Please review the changes and try again.

NOTE: Discounted line items are re-evaluated on cart actions and may be automatically added back to your cart with a new line item ID to satisfy promotional requirements.

The cart version that you expect to apply the updates. If the provided version doesn't match the current cart version, you will receive a conflict error. This field is optional; if not provided, optimistic concurrency control will not apply.

requestLineItems

Cart object used in create cart requests.

Create Cart Request Object

Simple product

Product with a variant

Line Item Request Data

Message shown to recipient, as provided by sender.

Name assigned to this gift-certificate line item.

Line Item Gift Certificate Request Data

Contact Entity

Line item

Gift certificate item

line & gift certificate items

requestLineItemPut

if passing null, it will remove the current gift wrapping for the item

Details for the gift wrapping option selected. This can be specified for each line item or together based on wrapTogether value.
If wrapTogether is false, each element in the wrapDetails array determines each item's specific wrapping. 
(e.g if this line item has 6 quantity, you can pass at maximum 6 elements for the array to spefified each one's wrapping)  
If wrapTogether is true, we will only use 1st element in the wrapDetails array to determine what to be wrapped

Boolean value that specifies whether items whether items should be wrapped together or wrapped individually.

Gift Wrapping Request Data

Cart object used in REST Storefront API cart responses.

Cost of cart’s contents, before applying discounts.

Sum of line-items amounts, minus cart-level discounts and coupons. This amount includes taxes (where applicable).

ID of the customer to which the cart belongs.

Order based discounted amount only - Coupon discounts and product based discounts are excluded.

The cart's email. This is the same email that is used in the billing address

Cart ID, provided after creating a cart with a POST.

The current version of the cart increments with each successful update. You can use it to enable optimistic concurrency control for subsequent updates.

Cart Read

The total value of all coupons applied to this item.

The total value of all discounts applied to this item (excluding coupon).

Item's list price multiplied by the quantity.

Item's sale price multiplied by the quantity.

URL of an image of this item, accessible on the internet.

Whether or not you can change or remove the item from the cart. Items that are immutable include those added automatically by promotions.

The net item price before discounts and coupons. BigCommerce derives an item’s list price from the product default price or, if applicable, the sale price configured in the admin panel.

The list of selected options for this product.

An item’s original price is the same as the product default price in the admin panel.

The product is part of a bundle such as a product pick list, then the parentId or the main product id will populate.

Item's price after all discounts are applied. (The final price before tax calculation.)

Base Item

|Type `int`|Type Name|
|-|-|
|`0`|`per_item_discount`|
|`1`|`percentage_discount`|
|`2`|`per_total_discount`|
|`3`|`shipping_discount`|
|`4`|`free_shipping`|
|`5`|`promotion`|

The discounted amount applied within a given context.

The coupon name displayed on the storefront.

Response Cart Coupons

This will always be the same between cart and checkout.

ISO-4217 currency code. (See: https://www.iso.org/iso-4217-currency-codes.html.)

The number of decimal places that prices have when you use the currency.

The name for the currency that the merchant entered in the control panel.

The currency symbol displayed on the storefront.

Currency

responseCartDiscounts

Response Line Items Object

**Read Only**

This will return in the Cart Response if the Cart was created using the [REST Management API](/docs/rest-management/carts). A custom item can only be added to a cart using the REST Management API.

Price of the item. With or without tax depending on your stores set up.

Item Custom

Item Digital

List of discounts applied to this item, as an array of AppliedDiscount objects.

Applied Discount

The product option name. For example, Color or Size

The product option identifier. It is the same as the `optionId` used in the request. 

The product option value. For example, Red or Medium

The product option value identifier. It is the same as the `optionValue` used in the request.

Product Option

Value must be between 1.00 and 1,000.00 in the storeʼs default currency.

Message that will be sent to the gift certificate's recipient. Limited to 200 characters.

GiftCertificate-provided name that will appear in the control panel.

Whether or not the gift certificate is taxable.

Item Gift Certificate

Item Physical

The product option identifier. It is the same as the `optionId` used in the request.

Whether this item requires shipping to a physical address.

Gift Wrapping

BigCommerce

Manage cart operations and data on BigCommerce-hosted storefronts. To work with headless storefronts, use the [GraphQL Storefront API](/graphql-storefront/reference).

The REST Storefront API uses [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) headers for authentication, and therefore has no required scopes. You do not need to send any BigCommerce-specific tokens with your requests to these endpoints.
    
For info about authenticating BigCommerce APIs, see [Authentication and Example Requests](/docs/start/authentication#same-origin-cors-authentication).

Storefront Carts

Returns a *Cart*.

> #### Note
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint.  

Creates a *Cart*.

> #### Note
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint.  

Deletes a *Cart*. Once a *Cart* has been deleted it can not be recovered.


> #### Note
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint.  

Update currency of the *Cart*. 
Promotions and gift certificates that don't apply to the new currency will be removed from your cart.
You cannot update the cart currency if the draft order cart or the cart contains a manual discount.

> #### Note
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint.  

Cart Currency Request Data

Adds a line items to the *Cart*.

> #### Notes
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint.  
> * To prevent lost updates due to concurrent requests overriding changes made by others, it is recommended to enable optimistic concurrency control by including the `version` field in the request payload. If the provided version does not match the version on the server, a conflict error will be returned, which the client can handle accordingly.

Deletes a *Cart* line item.

Removing the last `line_item` in the *Cart* deletes the *Cart*.

> #### Note
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint.  
> * To prevent lost updates due to concurrent requests overriding changes made by others, it is recommended to enable optimistic concurrency control by including the `version` field in the request payload. If the provided version does not match the version on the server, a conflict error will be returned, which the client can handle accordingly.

Updates a *Cart* line item. Updates an existing, single line item quantity and the price of custom items in a cart.

If a modified product or variant needs to be changed or updated, you can remove and re-add the product to the cart with the correct variants using the [Delete Cart Line Item](/docs/rest-storefront/carts/cart-items#delete-cart-line-item) and the [Add Cart Line Items](/docs/rest-storefront/carts/cart-items#add-cart-line-items) endpoints. You can also use carts mutations that are part of the [GraphQL Storefront API](/docs/storefront/cart-checkout/guide/graphql-storefront).


> #### Notes
> * Substitute your storefront domain for `yourstore.example.com`. 
> * The Send a Test Request feature is not currently supported for this endpoint. 
> * To prevent lost updates due to concurrent requests overriding changes made by others, it is recommended to enable optimistic concurrency control by including the `version` field in the request payload. If the provided version does not match the version on the server, a conflict error will be returned, which the client can handle accordingly.

The [URL authority](https://developer.mozilla.org/en-US/docs/Learn/Common_questions/Web_mechanics/What_is_a_URL#authority) of the storefront.

Cart Currency

Update Cart Currency