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 slot 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)
• Participant mapping - Uses ticketCategory keys from availability (e.g. adult, child)

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 as selection.price.amount on prebook, and for checkout handoff.

Option-level price

options[].price.amount reflects the lowest available slot price for the requested mix. Checkout uses the chosen slot's pricing.totals.net.

Error codes

Product-operation codes are listed below. Shared authentication/access/rate-limit middleware can return common codes such as 401, 40301 or 4290. HTTP status and error code are separate; do not parse message text.

{
  "language": "en",
  "currency": "EUR",
  "date": "2026-07-18",
  "participants": {
    "adult": 2,
    "child": 1
  },
  "addons": [
    {
      "id": 10,
      "quantity": 1
    }
  ]
}