Cart Items

Listing items on a cart — add (incl. from an encoded search selection), update dates/guests/quantity, remove, and pick a cancellation plan.

📄️ Add a listing item to the cart

Idempotent on (listingId, checkIn, checkOut) — re-adding sums the unit quantities.

📄️ Select a cancellation plan for an item

Picks a cancellation plan (e.g. a discounted non-refundable rate) from those available for the item's listing+channel. The plan's discount reduces the item's stay subtotal, before any cart-level coupon / bank offer. Each item's available plans are returned on the cart response.

📄️ Clear an item's cancellation plan (back to standard refundable)

Clear an item's cancellation plan (back to standard refundable)

📄️ Add an item from an encoded search selection

Decodes the `encodedId` returned on each listing search result (listing, stay dates, guest mix, and selected properties) and adds it as a cart item — no need to repeat those fields. Same idempotent (listingId, checkIn, checkOut) semantics as the regular add.

📄️ Remove an item from the cart

Remove an item from the cart

📄️ Update an item's dates / guests / quantity / position

Update an item's dates / guests / quantity / position