Skip to main content

Add multiple items to cart for a specific store

POST 
/api/v1/sdk/cart/store/:storeId/items/bulk

This endpoint adds multiple product variants to the cart in a single operation. More efficient than multiple single-item add calls.

Authentication: Requires customer authentication (JWT token with verified phone). Optional API key for additional store validation.

Use Cases:

  • Quick add of multiple products (e.g., from wishlist)
    • Re-ordering from previous orders
    • Importing shopping lists
    • POS or assisted checkout bulk operations

Behavior:

  • Each item is validated before adding
    • If an item already exists in cart, quantities are incremented
    • Partial success possible - successful items added even if some fail
    • Response includes details of any failed items

Error Scenarios:

  • 400 BAD REQUEST - Invalid request format, too many items, or validation errors (Error code: INVALID_REQUEST or TOO_MANY_ITEMS)
    • 404 NOT FOUND - Store not found (Error code: STORE_NOT_FOUND)
    • 401 UNAUTHORIZED - Customer not authenticated (Error code: UNAUTHORIZED)
    • 403 FORBIDDEN - API key doesn't have access to this store (Error code: NO_STORE_ACCESS)

Request​

Responses​

Items added successfully (check response for partial failures)