Add Booking Item

Add an item to an existing booking.

Method

POST /v1/bookings/:id/items

Path Parameters

id · string · required

Booking ID

Body Parameters

type · string · required

Item type (e.g., activity, room, addon)

inventoryItemId · uuid · required

Inventory item ID

supplierId · uuid

Supplier ID

departureId · uuid · required

Departure ID

startAt · date

Start date/time

endAt · date

End date/time

durationMinutes · number

Duration in minutes

quantity · number

Quantity (defaults to 1)

paxAdults · number

Adults for pricing context (defaults to booking adults)

paxChildren · number

Children for pricing context (defaults to booking children)

paxInfants · number

Infants for pricing context (defaults to booking infants)

paxCount · number

Override passengers count for this item

details · object

Provider-specific details

Hide examples

activity · object

Show example

{
  "meeting_point": "Lobby A",
  "language": "en",
  "guide_name": "Alice",
  "notes": "Wheelchair access required",
  "vendor_payload": { "ref": "EXT-12345" }
}

room · object

Show example

{
  "board": "half_board",
  "occupants": [
    { "type": "adult", "age": 34 },
    { "type": "child", "age": 7 }
  ],
  "rate_key": "HOTEL-ABC-2025-06-15",
  "cancellation_policy": "non_refundable"
}

addon · object

Show example

{
  "sku": "TRSF-ECON",
  "variant": "one_way",
  "attributes": { "vehicle": "sedan" }
}

The details object is integration-specific. Use these examples as guidance; concrete keys may differ by supplier. Choice-style customizations (e.g., groups/options/timeslots) are persisted via POST /v1/bookings/:bookingId/items/:itemId/options. Pricing is always calculated on the server; the response includes the computed unit and total amounts.

status · string

Item status

supplierReference · string

Supplier reference

voucherCode · string

Voucher code

notes · string

Notes

Headers

Authorization · string · required

Bearer token (e.g. Authorization: Bearer YOUR_API_KEY)

content-type · string

application/json

cURL

curl -X POST https://api.voyantcloud.com/v1/bookings/bkg_456def/items \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
  "type": "activity",
  "inventoryItemId": "2c5f3f8e-1111-2222-3333-abcdefabcdef",
  "departureId": "50d1c6aa-aaaa-bbbb-cccc-111122223333",
  "quantity": 1,
  "paxAdults": 2
}'

201 Created

{
  "id": "itm_123",
  "type": "activity",
  "status": "pending"
}