Tour Schemas

Tour

Properties

Property	Type	Description
`about`	`object`
`itinerary`	`object`
`logistics`	`object`
`pricing`	`object`
`booking_meta`	`object`

PricingRate

Properties

Property	Type	Description
`pricing_rate`	`string`
`min_age`	`integer`
`max_age`	`integer`

AvailabilityDay

Availability data for a single date. Each date key (format MM/DD/YYYY) in the availability object maps to this shape.

Properties

Property	Type	Description
`description`	`string`	Pricing description for the day (e.g., “Adult 12 hours”)
`currency`	`string`	Currency code for pricing on this day
`price`	`number`	Base price for the day
`reserve_for`	`number`	Partial-payment products. The amount the customer is expected to pay at booking as a reservation fee, in the same currency as `price`. The remaining balance (`price - reserve_for`) is collected by the tour operator on the day of the tour. Field presence: Included whenever the product takes only a partial payment at booking. This covers both deposit-only products (where `booking_meta.deposit_only = "Yes"` on the corresponding tour) and products with a `min_payment` override that produces a reservation amount smaller than the full price. For full-payment products the field is omitted entirely – partners SHOULD treat its absence as “full payment due at booking” and charge `price` as normal. When present, partner UIs SHOULD render this value as the “due now” amount and present `price - reserve_for` as the balance owed to the operator.
`time`	`array`	Array of available time strings for this date
`time_with_description`	`array`

AvailabilitySlot

A single time slot with pricing details

Properties

Property	Type	Description
`time`	`string`
`description`	`string`
`currency`	`string`	Currency code for this slot’s pricing
`price`	`number`
`pricing_rates`	`array`

AvailabilityResponse

Top-level availability response. pricing_model and pricing_rates are siblings of availability, not nested inside it. The availability object is a pure date-keyed map (format MM/DD/YYYY) where every value is an AvailabilityDay.

Properties

Property	Type	Description
`pricing_model`	`string`	Indicates how the product is priced. “Per Person” means each traveler type (Adult, Child, etc.) has its own rate. “Unit” means pricing is per unit of time, occupancy, or a flat rate.
`pricing_rates`	`array`	Product-level rate definitions with age ranges. These are the canonical rate types for the product, independent of any specific date or time slot.
`availability`	`object`	Date-keyed map (format `MM/DD/YYYY`). Every key is a date string and every value is an AvailabilityDay.