Get merged booking options

Overview

Resolve priced booking options, time slots, and required guest inputs for a selected tour date and participant mix.

When to Use

  • Option/slot pickers - Show available variants and start times for a date
  • Live pricing - Display authoritative slot sell totals (pricing.totals.net / priceSummary.netPrice)
  • Checkout forms - Collect bookingQuestionSchema before proceeding to payment

What You Get

  • Booking options - optionId, title, and bookingQuestionSchema
  • Time slots - dateTime, isAvailable, and slot-level pricing (unitNet / totalNet / totals.net / priceSummary.netPrice, plus totals.commission when markup applies)
  • Participant mapping - Uses ticketCategory keys from availability (e.g. adult, child)

Money semantics

Field names keep *Net from experiences-api; dispatcher marks commercial net up in place to partner sell. Use slots[].pricing.totals.net as selection.price.amount on prebook.

Quick Start

POST a body with language, currency, date (YYYY-MM-DD), and participants to /experiences/tours/{id}/booking-options. Use slot pricing.totals.net for display and checkout handoff.

Option-level price

options[].price.amount is overwritten from the lowest available slot pricing.totals.net for the requested mix (after markup). It is not the GYG catalog from-price. Checkout still uses the chosen slot pricing.totals.net.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Tour identifier

Body Params
string
required

ISO language code for localized content.

string
required

ISO 4217 currency code for prices.

date
required

Tour date to price, YYYY-MM-DD.

participants
object
required

Participant counts keyed by ticket category (age band), e.g. adult, child. Keys are lowercase and must match a ticketCategory returned by GET /experiences/tours/{id}/availability for this tour. An array (e.g. [{"category":"adult","count":2}]) is rejected, and uppercase keys (e.g. ADULT) are rejected - use the exact lowercase category strings from availability.

addons
array of objects

Optional add-ons to price alongside the tour, from GET .../availability addons[].id.

addons
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json