Add an item to the cart

POST /v1/cart/items

Add an item to the cart

cURL

curl --request POST \
  --url https://api.example.com/v1/cart/items \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "productId": "b6a1e2d4-8f3c-4a5b-9e2d-1f4c6a8b9d0e",
  "quantity": 2,
  "sizeId": "3c1e9a7b-2d4f-4b6a-8c9d-0e1f2a3b4c5d"
}
'

200

{
  "id": "<string>",
  "userId": "<string>",
  "items": [
    {
      "id": "<string>",
      "productId": "<string>",
      "productName": "<string>",
      "quantity": 123,
      "unitPrice": 123,
      "available": true,
      "productImage": "<string>",
      "sizeId": "<string>",
      "variantName": "<string>",
      "sizeLabel": "<string>",
      "size": "<string>"
    }
  ],
  "bundles": [
    {
      "id": "<string>",
      "bundleId": "<string>",
      "name": "<string>",
      "quantity": 123,
      "unitPrice": 123,
      "lineTotal": 123,
      "components": [
        {
          "productId": "<string>",
          "sizeId": "<string>",
          "productName": "<string>",
          "variantName": "<string>",
          "sizeLabel": "<string>",
          "sku": "<string>",
          "quantity": 123
        }
      ],
      "image": "<string>"
    }
  ],
  "subtotal": 123
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

authorization · string · required

Body

application/json

productId · string · required

Example:

"b6a1e2d4-8f3c-4a5b-9e2d-1f4c6a8b9d0e"

quantity · number · required

Required range: x >= 1

Example:

2

sizeId · string

Which size. May be omitted only when the product has exactly one active size; the same size again adds to its line.

Example:

"3c1e9a7b-2d4f-4b6a-8c9d-0e1f2a3b4c5d"

Response

200 - application/json

id · string · required

userId · string · required

items · object[] · required

Show child attributes

bundles · object[] · required

Bundle packages, each at its bundle price

Show child attributes

subtotal · number · required

Available items + bundles