> For the complete documentation index, see [llms.txt](https://docs.digitalriver.com/commerce-api/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/shopper-apis/cart/getting-the-current-cart.md). # Getting the current cart You must send a [`GET /v1/shoppers/me/carts/active`](https://docs.digitalriver.com/commerce-api-references/shopper-apis/cart/cart-offers) request to obtain the details of a shopper's currently active shopping cart. It will return a JSON response with all the relevant cart information, such as product details, pricing, and applicable taxes. The following sections provide step-by-step instructions on how to retrieve the active cart using a simple cURL command. To get the current cart, send a [`GET /v1/shoppers/me/carts/active`](https://docs.digitalriver.com/commerce-api-references/shopper-apis/cart/cart-offers) request with the appropriate headers. Replace `{Your_API_Key}` with your actual API key. Use the following cURL command to retrieve the active cart for a specified token: {% tabs %} {% tab title="cURL" %} ```http curl --location -g --request GET ' https://api.digitalriver.com/v1/shoppers/me/carts/active' \ --header 'Accept: application/json' \ --header 'Authorization: Basic {Your_API_Key}' \ --header 'Content-Type: application/json' ``` {% endtab %} {% tab title="200 OK response" %} ```javascript { "cart": { "uri": "https://api.digitalriver.com/v1/shoppers/me/carts/active", "paymentMethods": { "uri": "https://api.digitalriver.com/v1/shoppers/me/carts/active/payment-methods" }, "webCheckout": { "uri": "https://api.digitalriver.com/v1/shoppers/me/carts/active/web-checkout" }, "id": 278666810197, "lineItems": { "uri": "https://api.digitalriver.com/v1/shoppers/me/carts/active/line-items", "lineItem": [ { "uri": "https://api.digitalriver.com/v1/shoppers/me/carts/active/line-items/14052737700", "id": 14052737700, "quantity": 1, "product": { "uri": "https://api.digitalriver.com/v1/shoppers/me/products/8027217700", "displayName": "Combination Product", "thumbnailImage": null }, "pricing": { "listPrice": { "currency": "USD", "value": 36 }, "listPriceWithQuantity": { "currency": "USD", "value": 36 }, "salePriceWithQuantity": { "currency": "USD", "value": 36 }, "formattedListPrice": "$36.00", "formattedListPriceWithQuantity": "$36.00", "formattedSalePriceWithQuantity": "$36.00", "productTax": { "currency": "USD", "value": 0 }, "shippingTax": { "currency": "USD", "value": 0 }, "feeTax": { "currency": "USD", "value": 0 }, "taxRate": 0.08525, "importTax": { "currency": "USD", "value": 0 }, "formattedImportTax": "$0.00", "importDuty": { "currency": "USD", "value": 0 }, "formattedImportDuty": "$0.00" }, "components": { "lineItem": [ { "uri": "https://api.digitalriver.com/v1/shoppers/me/carts/active/line-items/14052737700", "id": 14052737700, "quantity": 1, "product": { "uri": "https://api.digitalriver.com/v1/shoppers/me/products/257734900", "displayName": "Free trial product", "thumbnailImage": null, "recurringSubscriptionInfo": { "autoRenewal": "true", "termUnit": "WEEK", "termLength": "1" } }, "pricing": { "listPrice": { "currency": "USD", "value": 0 }, "listPriceWithQuantity": { "currency": "USD", "value": 0 }, "salePriceWithQuantity": { "currency": "USD", "value": 0 }, "formattedListPrice": "$0.00", "formattedListPriceWithQuantity": "$0.00", "formattedSalePriceWithQuantity": "$0.00", "productTax": { "currency": "USD", "value": 0 }, "shippingTax": { "currency": "USD", "value": 0 }, "feeTax": { "currency": "USD", "value": 0 }, "taxRate": 0.08525, "importTax": { "currency": "USD", "value": 0 }, "formattedImportTax": "$0.00", "importDuty": { "currency": "USD", "value": 0 }, "formattedImportDuty": "$0.00" } }, { "uri": "https://api.digitalriver.com/v1/shoppers/me/carts/active/line-items/14052747700", "id": 14052747700, "quantity": 1, "product": { "uri": "https://api.digitalriver.com/v1/shoppers/me/products/5505627700", "displayName": "AK123_Physical", "thumbnailImage": null }, "pricing": { "listPrice": { "currency": "USD", "value": 17 }, "listPriceWithQuantity": { "currency": "USD", "value": 17 }, "salePriceWithQuantity": { "currency": "USD", "value": 17 }, "formattedListPrice": "$17.00", "formattedListPriceWithQuantity": "$17.00", "formattedSalePriceWithQuantity": "$17.00", "productTax": { "currency": "USD", "value": 1.45 }, "shippingTax": { "currency": "USD", "value": 4.26 }, "feeTax": { "currency": "USD", "value": 0 }, "taxRate": 0.08525, "importTax": { "currency": "USD", "value": 0 }, "formattedImportTax": "$0.00", "importDuty": { "currency": "USD", "value": 0 }, "formattedImportDuty": "$0.00" } }, { "uri": "https://api.digitalriver.comi/v1/shoppers/me/carts/active/line-items/14052757700", "id": 14052757700, "quantity": 1, "product": { "uri": "https://api.digitalriver.com/v1/shoppers/me/products/6686217700", "displayName": "Auto_Monthly_Sub", "thumbnailImage": null, "recurringSubscriptionInfo": { "autoRenewal": "true", "termUnit": "MONTH", "termLength": "1" } }, "pricing": { "listPrice": { "currency": "USD", "value": 19 }, "listPriceWithQuantity": { "currency": "USD", "value": 19 }, "salePriceWithQuantity": { "currency": "USD", "value": 19 }, "formattedListPrice": "$19.00", "formattedListPriceWithQuantity": "$19.00", "formattedSalePriceWithQuantity": "$19.00", "productTax": { "currency": "USD", "value": 0 }, "shippingTax": { "currency": "USD", "value": 0 }, "feeTax": { "currency": "USD", "value": 0 }, "taxRate": 0, "importTax": { "currency": "USD", "value": 0 }, "formattedImportTax": "$0.00", "importDuty": { "currency": "USD", "value": 0 }, "formattedImportDuty": "$0.00" } } ] } } ] }, "totalItemsInCart": 3, "businessEntityCode": "DR_INC-ENTITY", "billingAddress": { "uri": "https://api.digitalriver.com/v1/shoppers/me/carts/active/billing-address" }, "shippingAddress": { "uri": "https://api.digitalriver.com/v1/shoppers/me/carts/active/shipping-address" }, "payment": {}, "paymentSession": { "id": "f3e53825-3d20-4c40-afb8-1cde7bdb3a3b", "clientSecret": "f3e53825-3d20-4c40-afb8-1cde7bdb3a3b_ef9cb4c1-f56c-4535-bd57-1a313c2f006d", "status": "requires_source" }, "shippingMethod": { "code": 8046100, "description": "2 business days" }, "shippingOptions": { "uri": "https://api.digitalriver.com/v1/shoppers/me/carts/active/shipping-options" }, "taxInclusive": "false", "landedCostState": "NOT_ELIGIBLE", "pricing": { "subtotal": { "currency": "USD", "value": 36 }, "discount": { "currency": "USD", "value": 0 }, "shippingAndHandling": { "currency": "USD", "value": 50 }, "importTaxAndDuty": { "currency": "USD", "value": 0 }, "tax": { "currency": "USD", "value": 5.71 }, "orderTotal": { "currency": "USD", "value": 91.71 }, "formattedSubtotal": "$36.00", "formattedDiscount": "$0.00", "formattedShippingAndHandling": "$50.00", "formattedImportTaxAndDuty": "$0.00", "formattedTax": "$5.71", "formattedOrderTotal": "$91.71" }, "termsOfSalesAcceptance": null } } ``` {% endtab %} {% endtabs %} The `200 OK` response from the [`GET /v1/shoppers/me/carts/active`](https://docs.digitalriver.com/commerce-api-references/shopper-apis/cart/cart-offers) request details on various aspects of the active cart. If the product is a product combination, the combined product information appears under the `lineItem` object, and component information appears under the `components` object. ## Key information The key information in the JSON response from the `GET /v1/shoppers/me/carts/active` request includes: * **cart**: The main object containing all the details about the active shopping cart. * **uri**: The API endpoint to access the current cart details. * **paymentMethods**: This object includes the payment information displayed when using a Payment Source created payment. * **webCheckout**: URL for initiating a web-based checkout. * **id**: A unique identifier assigned to the cart. * **lineItems**: This object includes products in the cart, including their details such as name, quantity, and pricing. * **totalItemsInCart**: The total number of items in the cart. * **billingAddress** and **shippingAddress**: These objects include the cart's billing and shipping addresses. * **pricing**: A summary of the cart's costs, including subtotal, discounts, shipping, taxes, and order total. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs.digitalriver.com/commerce-api/shopper-apis/cart/getting-the-current-cart.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.