Add Items to Cart

Adds multiple product items to the customer’s cart in a single request.

POST /cart/add-items

Add multiple items to cart

cURL

curl --request POST \
  --url {protocol}://{host}/wp-json/cocart/v2/cart/add-items \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "id": "<string>",
      "quantity": "1",
      "variation": {},
      "item_data": {}
    }
  ],
  "email": "[e-mail]",
  "phone": "<string>",
  "return_items": false
}
'

200

[
  {
    "item_key": "<string>",
    "id": 123,
    "name": "<string>",
    "title": "<string>",
    "price": "<string>",
    "quantity": {
      "value": 123,
      "min_purchase": 123,
      "max_purchase": 123
    },
    "totals": {
      "subtotal": 123,
      "subtotal_tax": 123,
      "total": 123,
      "tax": 123
    },
    "slug": "<string>",
    "meta": {
      "product_type": "<string>",
      "sku": "<string>",
      "dimensions": {
        "length": "<string>",
        "width": "<string>",
        "height": "<string>",
        "unit": "<string>"
      },
      "weight": "<string>",
      "variation": {}
    },
    "backorders": "<string>",
    "cart_item_data": {},
    "featured_image": "<string>"
  }
]

Body

application/json

items · object[] · required

Array of items to add to the cart.

Show child attributes

email · string<email>

Set the customers billing email address.

phone · string

Set the customers billing phone number.

return_items · boolean · default: false

Returns the items details once added.

Response

200

application/json

Items added to cart successfully.

object[]

object

item_key · string

Unique identifier for the item within the cart.

id · integer

Product ID.

name · string

Product name.

title · string

Product title.

price · string

Current product price.

quantity · object

Quantity information for this item.

Show child attributes

totals · object

Item totals.

Show child attributes

slug · string

Product slug.

meta · object

Item metadata.

Show child attributes

backorders · string

Backorder status.

cart_item_data · object

Custom cart item data.

featured_image · string

Product featured image URL.