Create a Cart

POST

/store/carts

Create a Cart. Although optional, specifying the cart's region and sales channel can affect the cart's pricing and
the products that can be added to the cart respectively. So, make sure to set those early on and change them if necessary, such as when the customer changes their region.

If a customer is logged in, make sure to pass its ID or email within the cart's details so that the cart is attached to the customer.

Request

Body Params application/json

Example

{
    "region_id": "string",
    "sales_channel_id": "string",
    "country_code": "string",
    "context": {
        "ip": "::1",
        "user_agent": "Chrome"
    },
    "items": [
        {
            "variant_id": "string",
            "quantity": 0
        }
    ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.medusa-commerce.com/store/carts' \
--header 'Content-Type: application/json' \
--data-raw '{
    "region_id": "string",
    "sales_channel_id": "string",
    "country_code": "string",
    "context": {
        "ip": "::1",
        "user_agent": "Chrome"
    },
    "items": [
        {
            "variant_id": "string",
            "quantity": 0
        }
    ]
}'

Responses

🟢200Successfully created a new Cart

application/json

Body

Example

🟠400Client Error or Multiple Errors

🟠404Not Found Error

🟠409Invalid State Error

🟠422Invalid Request Error

🔴500Server Error

Modified at 2024-01-06 03:57:20

Delete a Payment Session

Get a Cart