Skip to main content
PATCH
/
api
/
v1
/
locations
/
{locationId}
/
carts
/
{cartId}
/
cart-item
/
{itemId}
/
quantity
{
  "quantity": 3
}

{
  "fulfillmentMethod": "takeout",
  "totalQuantity": 5,
  "subTotal": "22.50",
  "taxTotal": "0.00",
  "orderTotal": "26.55",
  "discountTotal": "0.00",
  "orderTotalWithServiceFee": "27.11",
  "waiterTipTotal": "4.05",
  "serviceFeeTotal": "0.56",
  "deliveryFeeTotal": "0.56",
  "enterpriseFeeTotal": "0.00",
  "subTotalWithoutDiscount": "22.50",
  "taxAndFeeTotal": "0.56",
  "fees": {
    "enterpriseFeeRate": "0.0000",
    "enterpriseFeeFix": "0.00",
    "serviceFeeRate": "0.025",
    "serviceFeeFix": "0.00",
    "taxRate": "0.00",
    "tipRate": "0.18",
    "deliveryFeeFix": "0.00",
    "deliveryFeeRate": "0.0000"
  },
  "items": [
    {
      "id": "687a186d1907e7930c347c23",
      "productId": "687611d1ccc9121bb3e47b87",
      "name": "Classic Chocolate Chip",
      "imageUrl": "",
      "price": "4.50",
      "quantity": 5,
      "total": "22.50",
      "discount": "0.00",
      "categoryId": null,
      "specialInstructions": "",
      "itemUnavailableAction": "remove_item",
      "selectedModifiers": []
    }
  ],
  "updatedAt": "2025-07-18T09:48:53.522Z",
  "id": "687a184e1907e7930c347c16"
}

​
Path Parameters

​
locationId
string
required
The unique identifier for the restaurant location
​
cartId
string
required
The unique identifier for the cart
​
itemId
string
required
The unique identifier for the cart item to update

​
Request Body

​
quantity
number
required
The new quantity for the item (must be non-negative number)
{
  "quantity": 3
}

{
  "fulfillmentMethod": "takeout",
  "totalQuantity": 5,
  "subTotal": "22.50",
  "taxTotal": "0.00",
  "orderTotal": "26.55",
  "discountTotal": "0.00",
  "orderTotalWithServiceFee": "27.11",
  "waiterTipTotal": "4.05",
  "serviceFeeTotal": "0.56",
  "deliveryFeeTotal": "0.56",
  "enterpriseFeeTotal": "0.00",
  "subTotalWithoutDiscount": "22.50",
  "taxAndFeeTotal": "0.56",
  "fees": {
    "enterpriseFeeRate": "0.0000",
    "enterpriseFeeFix": "0.00",
    "serviceFeeRate": "0.025",
    "serviceFeeFix": "0.00",
    "taxRate": "0.00",
    "tipRate": "0.18",
    "deliveryFeeFix": "0.00",
    "deliveryFeeRate": "0.0000"
  },
  "items": [
    {
      "id": "687a186d1907e7930c347c23",
      "productId": "687611d1ccc9121bb3e47b87",
      "name": "Classic Chocolate Chip",
      "imageUrl": "",
      "price": "4.50",
      "quantity": 5,
      "total": "22.50",
      "discount": "0.00",
      "categoryId": null,
      "specialInstructions": "",
      "itemUnavailableAction": "remove_item",
      "selectedModifiers": []
    }
  ],
  "updatedAt": "2025-07-18T09:48:53.522Z",
  "id": "687a184e1907e7930c347c16"
}

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
locationId
string
required

The unique identifier for the restaurant location

​
cartId
string
required

The unique identifier for the cart

​
itemId
string
required

The unique identifier for the cart item to update

Body

application/json
​
quantity
number
required

The new quantity for the item (must be non-negative number)

Response

Item quantity updated successfully.

​
fulfillmentMethod
string

The fulfillment method for the order

​
totalQuantity
integer

Total quantity of all items in the cart

​
subTotal
string

Subtotal amount before taxes and fees

​
taxTotal
string

Total tax amount

​
orderTotal
string

Order total including tax and tip

​
discountTotal
string

Total discount amount

​
orderTotalWithServiceFee
string

Final order total including service fee

​
waiterTipTotal
string

Total tip amount

​
serviceFeeTotal
string

Service fee amount

​
deliveryFeeTotal
string

Delivery fee amount

​
enterpriseFeeTotal
string

Enterprise fee amount

​
subTotalWithoutDiscount
string

Original subtotal before discounts

​
taxAndFeeTotal
string

Combined total of taxes and fees

​
fees
object

Breakdown of all fee rates and amounts

​
items
object[]

Array of items in the cart

​
updatedAt
string

ISO 8601 timestamp of when the cart was last updated

​
id
string

Cart ID