> This page is for Developer. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.bigcommerce.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server. # Add Cart Line Items POST https://your_store.example.com/api/storefront/carts/{cartId}/items Content-Type: application/json 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. Reference: https://docs.bigcommerce.com/developer/api-reference/rest/storefront/carts/cart-items/add-cart-line-item ## Request ### Path parameters - `cartId` (string, required) — This cartʼs unique ID. ### Query parameters - `include` (list of enum, optional) — Sub-resources to include in the Cart response, in a comma-separated list. `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. `lineItems.physicalItems.stockPosition`: Returns backorder and stock availability details for physical items. `lineItems.digitalItems.stockPosition`: Returns backorder and stock availability details for digital items. Since digital products cannot be backordered, backorder values are always zero. - Allowed values: `lineItems.physicalItems.options`, `lineItems.digitalItems.options`, `lineItems.physicalItems.stockPosition`, `lineItems.digitalItems.stockPosition` ### Headers - `Accept` (string, required, default: application/json) — The [MIME type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) of the response body. ### Body (application/json) This endpoint expects a LineItemsRequest. - `LineItemsRequest` ## Response ### 200 The cart, including the newly added items. - `id` (string, optional) — Cart ID, provided after creating a cart with a POST. - `customerId` (integer, optional) — ID of the customer to which the cart belongs. - `email` (string, optional) — The cart's email. This is the same email that is used in the billing address - `currency` (responseCartCurrency, optional) — This will always be the same between cart and checkout. - `isTaxIncluded` (boolean, optional) — Whether this item is taxable. - `baseAmount` (double, optional) — Cost of cart’s contents, before applying discounts. - `discountAmount` (float, optional) — Order based discounted amount only - Coupon discounts and product based discounts are excluded. - `cartAmount` (double, optional) — Sum of line-items amounts, minus cart-level discounts and coupons. This amount includes taxes (where applicable). - `coupons` (list of ResponseCartCouponsItems, optional) - `discounts` (list of ResponseCartDiscountsItems, optional) - `lineItems` (responseCartLineItems, optional) - `createdTime` (string, optional) — Time when the cart was created. - `updatedTime` (string, optional) — Time when the cart was last updated. - `locale` (string, optional) — Locale of the cart. - `version` (integer, optional) — The current version of the cart increments with each successful update. You can use it to enable optimistic concurrency control for subsequent updates. ## Errors ### 409 Conflict Error Cart conflict - `status` (integer, optional) - `title` (string, optional) - `type` (string, optional) ## Types ### LineItemsRequest0 - `lineItems` (list of requestCartPostLineItem, required) - `version` (integer, optional) — 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. ### LineItemsRequest1 - `giftCertificates` (list of requestLineItemGiftCertificate, required) - `version` (integer, optional) — 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. ### LineItemsRequest2 - `lineItems` (list of requestCartPostLineItem, required) - `giftCertificates` (list of requestLineItemGiftCertificate, required) - `version` (integer, optional) — 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. ### responseCartCurrency This will always be the same between cart and checkout. - `code` (string, optional) — ISO-4217 currency code. (See: https://www.iso.org/iso-4217-currency-codes.html.) - `decimalPlaces` (integer, optional) — The number of decimal places that prices have when you use the currency. - `name` (string, optional) — The name for the currency that the merchant entered in the control panel. - `symbol` (string, optional) — The currency symbol displayed on the storefront. ### ResponseCartCouponsItems - `code` (string, required) — The coupon code. - `couponType` (integer, optional) — |Type `int`|Type Name| |-|-| |`0`|`per_item_discount`| |`1`|`percentage_discount`| |`2`|`per_total_discount`| |`3`|`shipping_discount`| |`4`|`free_shipping`| |`5`|`promotion`| - `discountedAmount` (float, optional) — The discounted amount applied within a given context. - `displayName` (string, optional) — The coupon name displayed on the storefront. - `id` (string, optional) — The coupon ID. ### ResponseCartDiscountsItems - `discountedAmount` (float, optional) — The discounted amount applied within a given context. - `id` (string, optional) — ID of the applied discount. ### responseCartLineItems - `customItems` (list of responseCartLineItemsCustomItems, optional) - `digitalItems` (list of responseCartLineItemsDigitalItems, optional) — Array of `ItemDigital` objects. - `giftCertificates` (list of responseCartLineItemsGiftCertificates, optional) — Array of `ItemGiftCertificate` objects. - `physicalItems` (list of responseCartLineItemsItemsPhysicalItemsItems, optional) — Array of `ItemPhysical` objects. ### requestCartPostLineItem ### requestLineItemGiftCertificate - `amount` (double, required) — Gift-certificate amount. - `name` (string, required) — Name assigned to this gift-certificate line item. - `quantity` (integer, required) — Quantity of this item. - `recipient` (requestLineItemGiftCertificateRecipient, required) - `sender` (requestLineItemGiftCertificateSender, required) - `theme` (string, required) — Currently supports `Birthday`, `Boy`, `Celebration`, `Christmas`, `General`, and `Girl`. - `message` (string, optional) — Message shown to recipient, as provided by sender. ### responseCartLineItemsCustomItems **Read Only** This will return in the Cart Response if the Cart was created using the [REST Management API](/developer/api-reference/rest/admin/management/carts). A custom item can only be added to a cart using the REST Management API. - `extendedListPrice` (integer, optional) - `id` (string, optional) — ID of the custom item - `listPrice` (integer, optional) — Price of the item. With or without tax depending on your stores set up. - `name` (string, optional) — Name of the custom item. - `quantity` (integer, optional) - `sku` (string, optional) — SKU of the custom item. ### responseCartLineItemsDigitalItems - `quantity` (double, required) — Quantity of this item. - `brand` (string, optional) — The products brand - `couponAmount` (double, optional) — The total value of all coupons applied to this item. - `discountAmount` (float, optional) — The total value of all discounts applied to this item (excluding coupon). - `discounts` (list of responseCartLineItemsDigitalItemsAllOf0DiscountsItems, optional) — List of discounts applied to this item, as an array of AppliedDiscount objects. - `extendedListPrice` (double, optional) — Item's list price multiplied by the quantity. - `extendedSalePrice` (double, optional) — Item's sale price multiplied by the quantity. - `id` (string, optional) — The line-item ID. - `imageUrl` (string, optional) — URL of an image of this item, accessible on the internet. - `isMutable` (boolean, optional) — Whether or not you can change or remove the item from the cart. Items that are immutable include those added automatically by promotions. - `isTaxable` (boolean, optional) — Whether the item is taxable. - `listPrice` (double, optional) — 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. - `name` (string, optional) — The item's product name. - `options` (list of responseCartLineItemsDigitalItemsAllOf0OptionsItems, optional) — The list of selected options for this product. - `originalPrice` (double, optional) — An item’s original price is the same as the product default price in the admin panel. - `parentId` (string, optional) — The product is part of a bundle such as a product pick list, then the parentId or the main product id will populate. - `productId` (double, optional) — ID of the product. - `salePrice` (double, optional) — Item's price after all discounts are applied. (The final price before tax calculation.) - `sku` (string, optional) — SKU of the variant. - `stockPosition` (ResponseCartLineItemsDigitalItemsAllOf0StockPosition, optional) — Backorder and stock availability details for this line item. Only returned when explicitly requested via `include=lineItems.digitalItems.stockPosition` — not included by default. Since digital products cannot be backordered, backorder values are always zero for digital items. - `type` (enum, optional) — The type of line item. - Allowed values: `digital` - `url` (string, optional) — The product URL. - `variantId` (double, optional) — ID of the variant. ### responseCartLineItemsGiftCertificates - `amount` (double, required) — Value must be between 1.00 and 1,000.00 in the storeʼs default currency. - `recipient` (responseCartLineItemsGiftCertificatesRecipient, required) - `sender` (responseCartLineItemsGiftCertificatesSender, required) - `theme` (string, required) — Currently supports `Birthday`, `Boy`, `Celebration`, `Christmas`, `General`, and `Girl`. - `id` (string, optional) — ID of this gift certificate. - `taxable` (boolean, optional) — Whether or not the gift certificate is taxable. - `message` (string, optional) — Message that will be sent to the gift certificate's recipient. Limited to 200 characters. - `name` (string, optional) — Name provided for the gift certificate that appears in the control panel. - `type` (enum, optional) — The type of line item. - Allowed values: `giftCertificate` ### responseCartLineItemsItemsPhysicalItemsItems - `quantity` (double, required) — Quantity of this item. - `brand` (string, optional) — The products brand - `couponAmount` (double, optional) — The total value of all coupons applied to this item. - `discountAmount` (float, optional) — The total value of all discounts applied to this item (excluding coupon). - `discounts` (list of ResponseCartDiscountsItems, optional) - `extendedListPrice` (double, optional) — Item's list price multiplied by the quantity. - `extendedSalePrice` (double, optional) — Item's sale price multiplied by the quantity. - `giftWrapping` (responseCartLineItemsPhysicalItemGiftWrapping, optional) - `id` (string, optional) — The line-item ID. - `imageUrl` (string, optional) — URL of an image of this item, accessible on the internet. - `isMutable` (boolean, optional) — Whether or not you can change or remove the item from the cart. Items that are immutable include those added automatically by promotions. - `isShippingRequired` (boolean, optional) — Whether this item requires shipping to a physical address. - `isTaxable` (boolean, optional) — Whether the item is taxable. - `listPrice` (double, optional) — 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. - `name` (string, optional) — The item's product name. - `options` (list of responseCartLineItemsItemsPhysicalItemsItemsAllOf0OptionsItems, optional) — The list of selected options for this product. - `originalPrice` (double, optional) — An item’s original price is the same as the product default price in the admin panel. - `parentId` (double, optional) — The product is part of a bundle such as a product pick list, then the parentId or the main product id will populate. - `productId` (double, optional) — ID of the product. - `salePrice` (double, optional) — Item's price after all discounts are applied. (The final price before tax calculation.) - `sku` (string, optional) — SKU of the variant. - `stockPosition` (ResponseCartBaseItemStockPosition, optional) — Backorder and stock availability details for this line item. Only returned when explicitly requested via `include=lineItems.physicalItems.stockPosition` (or the `digitalItems` equivalent) — not included by default. - `type` (enum, optional) — The type of line item. - Allowed values: `physical` - `url` (string, optional) — The product URL. - `variantId` (double, optional) — ID of the variant. ### Simple product - `productId` (double, required) — ID of the product. - `quantity` (double, required) — Quantity of this item. - `optionSelections` (list of RequestCartPostLineItemOneOf0OptionSelectionsItems, optional) - `giftWrapping` (requestPostOrPutGiftWrapping, optional) — if passing null, it will remove the current gift wrapping for the item ### Product with a variant - `productId` (double, required) — ID of the product. - `quantity` (double, required) — Quantity of this item. - `variantId` (double, optional) — ID of the variant. - `optionSelections` (list of RequestCartPostLineItemOneOf1OptionSelectionsItems, optional) - `giftWrapping` (requestPostOrPutGiftWrapping, optional) — if passing null, it will remove the current gift wrapping for the item ### requestLineItemGiftCertificateRecipient - `email` (string, optional) — Contact's email address. - `name` (string, optional) — Contact's name. ### requestLineItemGiftCertificateSender - `email` (string, optional) — Contact's email address. - `name` (string, optional) — Contact's name. ### responseCartLineItemsDigitalItemsAllOf0DiscountsItems - `discountedAmount` (float, optional) — The discounted amount applied within a given context. - `id` (double, optional) — ID of the applied discount. ### responseCartLineItemsDigitalItemsAllOf0OptionsItems - `name` (string, optional) — The product option name. For example, Color or Size - `nameId` (double, optional) — The product option identifier. It is the same as the `optionId` used in the request. - `value` (string, optional) — The product option value. For example, Red or Medium - `valueId` (double, optional) — The product option value identifier. It is the same as the `optionValue` used in the request. ### ResponseCartLineItemsDigitalItemsAllOf0StockPosition Backorder and stock availability details for this line item. Only returned when explicitly requested via `include=lineItems.digitalItems.stockPosition` — not included by default. Since digital products cannot be backordered, backorder values are always zero for digital items. - `quantityOnHand` (integer, optional) — Number of units currently in stock and available to fulfill this line item without backordering. - `quantityBackordered` (integer, optional) — Number of units from this line item that are fulfilled via backorder. - `quantityOutOfStock` (integer, optional) — Number of units from this line item that are out of stock and unavailable for backorder. - `backorderMessage` (string, optional, nullable) — Backorder messaging shown to the customer for this line item. `null` if no backorder message applies. ### responseCartLineItemsGiftCertificatesRecipient - `email` (string, optional) — Contact's email address. - `name` (string, optional) — Contact's name. ### responseCartLineItemsGiftCertificatesSender - `email` (string, optional) — Contact's email address. - `name` (string, optional) — Contact's name. ### responseCartLineItemsPhysicalItemGiftWrapping - `amount` (float, optional) — Gift-wrapping price per product. - `message` (string, optional) - `name` (string, optional) — Name of the gift-wrapping option. ### responseCartLineItemsItemsPhysicalItemsItemsAllOf0OptionsItems - `name` (string, optional) — The product option name. For example, Color or Size - `nameId` (double, optional) — The product option identifier. It is the same as the `optionId` used in the request. - `value` (string, optional) — The product option value. For example, Red or Medium - `valueId` (double, optional) — The product option value identifier. It is the same as the `optionValue` used in the request. ### ResponseCartBaseItemStockPosition Backorder and stock availability details for this line item. Only returned when explicitly requested via `include=lineItems.physicalItems.stockPosition` (or the `digitalItems` equivalent) — not included by default. - `quantityOnHand` (integer, optional) — Number of units currently in stock and available to fulfill this line item without backordering. - `quantityBackordered` (integer, optional) — Number of units from this line item that are fulfilled via backorder. - `quantityOutOfStock` (integer, optional) — Number of units from this line item that are out of stock and unavailable for backorder. - `backorderMessage` (string, optional, nullable) — Backorder messaging shown to the customer for this line item. `null` if no backorder message applies. ### RequestCartPostLineItemOneOf0OptionSelectionsItems - `optionId` (integer, optional) — Modifier option ID. - `optionValue` (RequestCartPostLineItemOneOf0OptionSelectionsItemsOptionValue, optional) — Modifier option value. ### requestPostOrPutGiftWrapping if passing null, it will remove the current gift wrapping for the item - `wrapTogether` (boolean, required) — Boolean value that specifies whether items whether items should be wrapped together or wrapped individually. - `wrapDetails` (list of RequestPostOrPutGiftWrappingWrapDetailsItems, required) — 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 ### RequestCartPostLineItemOneOf1OptionSelectionsItems - `optionId` (integer, optional) — Modifier option ID. - `optionValue` (RequestCartPostLineItemOneOf1OptionSelectionsItemsOptionValue, optional) — Modifier option value. ### RequestCartPostLineItemOneOf0OptionSelectionsItemsOptionValue Modifier option value. ### RequestPostOrPutGiftWrappingWrapDetailsItems - `id` (integer, required) — Identifier of the gift wrapping option selected. - `message` (string, optional) — Custom gift message. ### RequestCartPostLineItemOneOf1OptionSelectionsItemsOptionValue Modifier option value. ## Examples ### Add cart line items **Request** ```json { "lineItems": [ { "optionSelections": [ { "optionId": 10, "optionValue": 117 }, { "optionId": 11, "optionValue": 125 } ], "productId": 230, "quantity": 2, "variantId": 124 } ], "version": 1 } ``` **Response** ```json { "id": "string", "customerId": 1, "email": "string", "currency": { "code": "string", "decimalPlaces": 1, "name": "US Dollar", "symbol": "$" }, "isTaxIncluded": true, "baseAmount": 1.1, "discountAmount": 1.1, "cartAmount": 1.1, "coupons": [ { "code": "string", "couponType": 1, "discountedAmount": 1.1, "displayName": "string", "id": "string" } ], "discounts": [ { "discountedAmount": 1.1, "id": "string" } ], "lineItems": { "customItems": [ { "extendedListPrice": 1, "id": "f1f3a531-fbcf-439b-bac1-40d5ae5c2bff", "listPrice": 10, "name": "Custom Item Name", "quantity": 1, "sku": "SM-456" } ], "digitalItems": [ { "quantity": 1.1, "brand": "string", "couponAmount": 1.1, "discountAmount": 1.1, "discounts": [ { "discountedAmount": 1.1, "id": 1.1 } ], "extendedListPrice": 1.1, "extendedSalePrice": 1.1, "id": "4", "imageUrl": "string", "isMutable": true, "isTaxable": true, "listPrice": 1.1, "name": "string", "options": [ { "name": "string", "nameId": 125, "value": "string", "valueId": 127 } ], "originalPrice": 1.1, "parentId": "6", "productId": 1.1, "salePrice": 1.1, "sku": "string", "stockPosition": { "quantityOnHand": 1, "quantityBackordered": 1, "quantityOutOfStock": 1, "backorderMessage": "string" }, "type": "digital", "url": "string", "variantId": 7 } ], "giftCertificates": [ { "amount": 1.1, "recipient": { "email": "string", "name": "string" }, "sender": { "email": "string", "name": "string" }, "theme": "string", "id": "string", "taxable": true, "message": "string", "name": "string", "type": "giftCertificate" } ], "physicalItems": [ { "quantity": 1.1, "brand": "string", "couponAmount": 1.1, "discountAmount": 1.1, "discounts": [ { "discountedAmount": 1.1, "id": "string" } ], "extendedListPrice": 1.1, "extendedSalePrice": 1.1, "giftWrapping": { "amount": 1.1, "message": "string", "name": "string" }, "id": "4", "imageUrl": "string", "isMutable": true, "isShippingRequired": true, "isTaxable": true, "listPrice": 1.1, "name": "string", "options": [ { "name": "string", "nameId": 125, "value": "string", "valueId": 127 } ], "originalPrice": 1.1, "parentId": 6, "productId": 1.1, "salePrice": 1.1, "sku": "string", "stockPosition": { "quantityOnHand": 1, "quantityBackordered": 1, "quantityOutOfStock": 1, "backorderMessage": "string" }, "type": "physical", "url": "string", "variantId": 7 } ] }, "createdTime": "string", "updatedTime": "string", "locale": "string", "version": 1 } ``` **SDK Code** ```python Add cart line items import requests url = "https://your_store.example.com/api/storefront/carts/cartId/items" payload = { "lineItems": [ { "optionSelections": [ { "optionId": 10, "optionValue": 117 }, { "optionId": 11, "optionValue": 125 } ], "productId": 230, "quantity": 2, "variantId": 124 } ], "version": 1 } headers = { "Accept": "application/json", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Add cart line items const url = 'https://your_store.example.com/api/storefront/carts/cartId/items'; const options = { method: 'POST', headers: {Accept: 'application/json', 'Content-Type': 'application/json'}, body: '{"lineItems":[{"optionSelections":[{"optionId":10,"optionValue":117},{"optionId":11,"optionValue":125}],"productId":230,"quantity":2,"variantId":124}],"version":1}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Add cart line items package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://your_store.example.com/api/storefront/carts/cartId/items" payload := strings.NewReader("{\n \"lineItems\": [\n {\n \"optionSelections\": [\n {\n \"optionId\": 10,\n \"optionValue\": 117\n },\n {\n \"optionId\": 11,\n \"optionValue\": 125\n }\n ],\n \"productId\": 230,\n \"quantity\": 2,\n \"variantId\": 124\n }\n ],\n \"version\": 1\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Accept", "application/json") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Add cart line items require 'uri' require 'net/http' url = URI("https://your_store.example.com/api/storefront/carts/cartId/items") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Accept"] = 'application/json' request["Content-Type"] = 'application/json' request.body = "{\n \"lineItems\": [\n {\n \"optionSelections\": [\n {\n \"optionId\": 10,\n \"optionValue\": 117\n },\n {\n \"optionId\": 11,\n \"optionValue\": 125\n }\n ],\n \"productId\": 230,\n \"quantity\": 2,\n \"variantId\": 124\n }\n ],\n \"version\": 1\n}" response = http.request(request) puts response.read_body ``` ```java Add cart line items import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://your_store.example.com/api/storefront/carts/cartId/items") .header("Accept", "application/json") .header("Content-Type", "application/json") .body("{\n \"lineItems\": [\n {\n \"optionSelections\": [\n {\n \"optionId\": 10,\n \"optionValue\": 117\n },\n {\n \"optionId\": 11,\n \"optionValue\": 125\n }\n ],\n \"productId\": 230,\n \"quantity\": 2,\n \"variantId\": 124\n }\n ],\n \"version\": 1\n}") .asString(); ``` ```php Add cart line items request('POST', 'https://your_store.example.com/api/storefront/carts/cartId/items', [ 'body' => '{ "lineItems": [ { "optionSelections": [ { "optionId": 10, "optionValue": 117 }, { "optionId": 11, "optionValue": 125 } ], "productId": 230, "quantity": 2, "variantId": 124 } ], "version": 1 }', 'headers' => [ 'Accept' => 'application/json', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Add cart line items using RestSharp; var client = new RestClient("https://your_store.example.com/api/storefront/carts/cartId/items"); var request = new RestRequest(Method.POST); request.AddHeader("Accept", "application/json"); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"lineItems\": [\n {\n \"optionSelections\": [\n {\n \"optionId\": 10,\n \"optionValue\": 117\n },\n {\n \"optionId\": 11,\n \"optionValue\": 125\n }\n ],\n \"productId\": 230,\n \"quantity\": 2,\n \"variantId\": 124\n }\n ],\n \"version\": 1\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Add cart line items import Foundation let headers = [ "Accept": "application/json", "Content-Type": "application/json" ] let parameters = [ "lineItems": [ [ "optionSelections": [ [ "optionId": 10, "optionValue": 117 ], [ "optionId": 11, "optionValue": 125 ] ], "productId": 230, "quantity": 2, "variantId": 124 ] ], "version": 1 ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://your_store.example.com/api/storefront/carts/cartId/items")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### Add cart line items with gift wrapping **Request** ```json { "lineItems": [ { "giftWrapping": { "wrapDetails": [ { "id": 1, "message": "Happy Birthday" } ], "wrapTogether": true }, "productId": 230, "quantity": 2, "variantId": 124 } ], "version": 1 } ``` **Response** ```json { "id": "string", "customerId": 1, "email": "string", "currency": { "code": "string", "decimalPlaces": 1, "name": "US Dollar", "symbol": "$" }, "isTaxIncluded": true, "baseAmount": 1.1, "discountAmount": 1.1, "cartAmount": 1.1, "coupons": [ { "code": "string", "couponType": 1, "discountedAmount": 1.1, "displayName": "string", "id": "string" } ], "discounts": [ { "discountedAmount": 1.1, "id": "string" } ], "lineItems": { "customItems": [ { "extendedListPrice": 1, "id": "f1f3a531-fbcf-439b-bac1-40d5ae5c2bff", "listPrice": 10, "name": "Custom Item Name", "quantity": 1, "sku": "SM-456" } ], "digitalItems": [ { "quantity": 1.1, "brand": "string", "couponAmount": 1.1, "discountAmount": 1.1, "discounts": [ { "discountedAmount": 1.1, "id": 1.1 } ], "extendedListPrice": 1.1, "extendedSalePrice": 1.1, "id": "4", "imageUrl": "string", "isMutable": true, "isTaxable": true, "listPrice": 1.1, "name": "string", "options": [ { "name": "string", "nameId": 125, "value": "string", "valueId": 127 } ], "originalPrice": 1.1, "parentId": "6", "productId": 1.1, "salePrice": 1.1, "sku": "string", "stockPosition": { "quantityOnHand": 1, "quantityBackordered": 1, "quantityOutOfStock": 1, "backorderMessage": "string" }, "type": "digital", "url": "string", "variantId": 7 } ], "giftCertificates": [ { "amount": 1.1, "recipient": { "email": "string", "name": "string" }, "sender": { "email": "string", "name": "string" }, "theme": "string", "id": "string", "taxable": true, "message": "string", "name": "string", "type": "giftCertificate" } ], "physicalItems": [ { "quantity": 1.1, "brand": "string", "couponAmount": 1.1, "discountAmount": 1.1, "discounts": [ { "discountedAmount": 1.1, "id": "string" } ], "extendedListPrice": 1.1, "extendedSalePrice": 1.1, "giftWrapping": { "amount": 1.1, "message": "string", "name": "string" }, "id": "4", "imageUrl": "string", "isMutable": true, "isShippingRequired": true, "isTaxable": true, "listPrice": 1.1, "name": "string", "options": [ { "name": "string", "nameId": 125, "value": "string", "valueId": 127 } ], "originalPrice": 1.1, "parentId": 6, "productId": 1.1, "salePrice": 1.1, "sku": "string", "stockPosition": { "quantityOnHand": 1, "quantityBackordered": 1, "quantityOutOfStock": 1, "backorderMessage": "string" }, "type": "physical", "url": "string", "variantId": 7 } ] }, "createdTime": "string", "updatedTime": "string", "locale": "string", "version": 1 } ``` **SDK Code** ```python Add cart line items with gift wrapping import requests url = "https://your_store.example.com/api/storefront/carts/cartId/items" payload = { "lineItems": [ { "giftWrapping": { "wrapDetails": [ { "id": 1, "message": "Happy Birthday" } ], "wrapTogether": True }, "productId": 230, "quantity": 2, "variantId": 124 } ], "version": 1 } headers = { "Accept": "application/json", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Add cart line items with gift wrapping const url = 'https://your_store.example.com/api/storefront/carts/cartId/items'; const options = { method: 'POST', headers: {Accept: 'application/json', 'Content-Type': 'application/json'}, body: '{"lineItems":[{"giftWrapping":{"wrapDetails":[{"id":1,"message":"Happy Birthday"}],"wrapTogether":true},"productId":230,"quantity":2,"variantId":124}],"version":1}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Add cart line items with gift wrapping package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://your_store.example.com/api/storefront/carts/cartId/items" payload := strings.NewReader("{\n \"lineItems\": [\n {\n \"giftWrapping\": {\n \"wrapDetails\": [\n {\n \"id\": 1,\n \"message\": \"Happy Birthday\"\n }\n ],\n \"wrapTogether\": true\n },\n \"productId\": 230,\n \"quantity\": 2,\n \"variantId\": 124\n }\n ],\n \"version\": 1\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Accept", "application/json") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Add cart line items with gift wrapping require 'uri' require 'net/http' url = URI("https://your_store.example.com/api/storefront/carts/cartId/items") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Accept"] = 'application/json' request["Content-Type"] = 'application/json' request.body = "{\n \"lineItems\": [\n {\n \"giftWrapping\": {\n \"wrapDetails\": [\n {\n \"id\": 1,\n \"message\": \"Happy Birthday\"\n }\n ],\n \"wrapTogether\": true\n },\n \"productId\": 230,\n \"quantity\": 2,\n \"variantId\": 124\n }\n ],\n \"version\": 1\n}" response = http.request(request) puts response.read_body ``` ```java Add cart line items with gift wrapping import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://your_store.example.com/api/storefront/carts/cartId/items") .header("Accept", "application/json") .header("Content-Type", "application/json") .body("{\n \"lineItems\": [\n {\n \"giftWrapping\": {\n \"wrapDetails\": [\n {\n \"id\": 1,\n \"message\": \"Happy Birthday\"\n }\n ],\n \"wrapTogether\": true\n },\n \"productId\": 230,\n \"quantity\": 2,\n \"variantId\": 124\n }\n ],\n \"version\": 1\n}") .asString(); ``` ```php Add cart line items with gift wrapping request('POST', 'https://your_store.example.com/api/storefront/carts/cartId/items', [ 'body' => '{ "lineItems": [ { "giftWrapping": { "wrapDetails": [ { "id": 1, "message": "Happy Birthday" } ], "wrapTogether": true }, "productId": 230, "quantity": 2, "variantId": 124 } ], "version": 1 }', 'headers' => [ 'Accept' => 'application/json', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Add cart line items with gift wrapping using RestSharp; var client = new RestClient("https://your_store.example.com/api/storefront/carts/cartId/items"); var request = new RestRequest(Method.POST); request.AddHeader("Accept", "application/json"); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"lineItems\": [\n {\n \"giftWrapping\": {\n \"wrapDetails\": [\n {\n \"id\": 1,\n \"message\": \"Happy Birthday\"\n }\n ],\n \"wrapTogether\": true\n },\n \"productId\": 230,\n \"quantity\": 2,\n \"variantId\": 124\n }\n ],\n \"version\": 1\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Add cart line items with gift wrapping import Foundation let headers = [ "Accept": "application/json", "Content-Type": "application/json" ] let parameters = [ "lineItems": [ [ "giftWrapping": [ "wrapDetails": [ [ "id": 1, "message": "Happy Birthday" ] ], "wrapTogether": true ], "productId": 230, "quantity": 2, "variantId": 124 ] ], "version": 1 ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://your_store.example.com/api/storefront/carts/cartId/items")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```