Cart

Agent-built named quote drafts. Each cart belongs to the agent identified by the JWT; an agent can only see and edit carts they created.

📄️ List my carts

Paginated. 1-based page index.

📄️ Create a cart

The cart is auto-named from the agent's name: first 4 characters + an incremental 4-digit sequence per agent (e.g. `Pooj0001`, `Pooj0002`). Pass an explicit `name` to override. The cart can be renamed at any time via PATCH.

📄️ Fetch a cart with re-priced lines and drift flags

Fetch a cart with re-priced lines and drift flags

📄️ Archive a cart (soft-delete)

Archive a cart (soft-delete)

📄️ Rename / relabel a cart

Only the cart name and customer label are editable. Channel is fixed at creation and status is not changed here (use DELETE to archive).

📄️ Duplicate a cart with a new name

Clones items, meal selections, and VAS selections. Prices are re-snapshotted from today.

📄️ Add a listing item to the cart

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

📄️ Set or replace meal selection on an item

Replaces any prior selection for the same meal. Pass `unsureOfDates=true` (or omit `dates`) to apply the meal across every night of the stay.

📄️ Set or replace a Value-Added Service selection on an item

Replaces any prior selection for the same vasId. Same date-fan-out semantics as meals.

📄️ 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.

📄️ Accept current prices

Overwrites all snapshots with today's pricing. Use before sharing the cart with a customer.

📄️ 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

📄️ Drop a meal selection from an item

Drop a meal selection from an item

📄️ Drop a VAS selection from an item

Drop a VAS selection from an item