---
title: "Add an item to the guest storefront cart"
method: POST
path: "/v3/stores/{store_id}/public/cart/items"
tags: ["Storefront"]
---

# Add an item to the guest storefront cart

`POST /v3/stores/{store_id}/public/cart/items`

## Request

- Base URL: `https://api.scalev.com`
- URL: `https://api.scalev.com/v3/stores/{store_id}/public/cart/items`
- Auth: none required

Public storefront endpoint. Direct cart additions are store-scoped and not blocked by storefront listing visibility.

## Request body

- union
  - CartVariantItemRequest
    - `type` 'variant', required
    - `variant_id` union, required
      - integer
      - string
    - `quantity` integer
  - CartBundlePriceOptionItemRequest
    - `type` 'bundle_price_option', required
    - `bundle_price_option_id` union, required: Bundle price option ID from the storefront catalog.
      - integer
      - string
    - `quantity` integer

## Response `201`

Guest cart

- GuestCart
  - `id` integer
  - `item_count` integer
  - `total` union
    - string
    - number
  - `items` GuestCartItem[]
    - union
      - GuestCartVariantItem
        - `id` integer, required
        - `type` 'variant', required
        - `variant_id` integer, required
        - `bundle_price_option_id` integer, nullable, required
        - `quantity` integer, required
      - GuestCartBundlePriceOptionItem
        - `id` integer, required
        - `type` 'bundle_price_option', required
        - `variant_id` integer, nullable, required
        - `bundle_price_option_id` integer, required
        - `bundle_price_option_slug` string
        - `bundle_price_option_unique_id` string
        - `quantity` integer, required

## Other responses

- `400`: Bad Request
- `404`: Not Found

---

[API](https://skmtc.dev/scalev/apis/nexus-commerce-api.md) - [All operations](https://skmtc.dev/scalev/apis/nexus-commerce-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scalev/apis/nexus-commerce-api/revisions/6b9152f04622?raw)