Book

post

https://holidays-volt-sandbox.travclan.com/api/v1/fixed-departure/listings/{code}/book

Books a departure: blocks the seats and creates a provisional booking. TravClan later confirms the booking and assigns a final booking code.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

code

string

required

Package ID, the same code used for Detail.

Body Params

Send every field. Use [] when nothing was chosen. Traveller documents and details are not sent here; send them to your ACM with the same buyer_booking_reference.

departure_code

string

required

data.departures[].code of the selected departure.

buyer_booking_reference

string

required

Mandatory. Your own unique reference for this booking, normally your payment reference. TravClan uses it to match the booking when sending the final booking code.

occupancy

array of objects

required

One item per room.

occupancy*

hotels

array of strings

required

data.hotels[].code of every included hotel stay.

hotels*

hotel_upgrades

array of objects

required

One item per chosen hotel upgrade. [] if none.

hotel_upgrades*

sightseeings

array of strings

required

data.sightseeings[].sightseeing.code of the included activities.

sightseeings*

sightseeing_addon_codes

array of strings

required

data.addons[].code of each optional activity chosen. [] if none.

sightseeing_addon_codes*

transfers

array of strings

required

data.transfers[].transfer.code of the included transfers.

transfers*

transfer_addon_codes

array of strings

required

data.transfers[].addons[].code of each transfer add-on chosen. [] if none.

transfer_addon_codes*

flights

array of strings

required

data.flights[].code of the included flights.

flights*

flight_origin_addon_codes

array of strings

required

data.flights[].outbound.origin_addons[].code of the start city chosen. [] if none.

flight_origin_addon_codes*

total_amount

number

required

The total you calculate room by room with the pricing rules, including upgrades and add-ons. Must match the current price.

currency

string

required

data.departures[].currency of the selected departure.

Responses

500

Unexpected error.

200Provisional booking created (status CONFIRMED, internal_booking_status PENDING).

400Invalid body, occupancy, components, inventory or currency.

401Missing or invalid API key.

404Listing not found, or not bookable for your organisation.

409Prices have changed: total_amount does not match the current price.