Skip to content

Booking Schemas

Full booking details response

Property Type Description
info object
meta object
operator object
pax object
pricing object
partner object
transportation object Only included for transfer bookings

Property Type Description
product_id string Product ID (e.g., “PRD12031”)
type string
date string
time string Tour start time
phone object
email string Contact email address
lead_pax string Lead passenger name
adults string Comma-separated adult names (By Person Type pricing)
children string Comma-separated children names
youth string Comma-separated youth names
students string Comma-separated student names
infants string Comma-separated infant names
participants integer Total number of participants
partner_ref string Your internal booking reference
internal_notes string
hotel_pickup string Hotel pickup location (if product allows)
traveler_questions string Answers to custom questions (required if product has custom_mandatory=1)
language string Preferred tour language
private_tour boolean Book as private tour
description string Conditionally required for products using the By API pricing model when multiple price slots exist. Pass the description value from the /return_availability response to select the correct slot (e.g., “With tickets” vs “Without tickets”). Can be omitted when only one slot is available.
token string Stripe payment token (if not on credit terms)
card_holder string Cardholder name (if paying by card)

Property Type Description
reference_id string Booking reference to cancel (also accepts id as alias)
reason string Reason for cancellation (mandatory)

Property Type Description
id string Booking reference
notes string Update request details