Overview

Retrieve available dates and time slots for a specific tour so users can pick when to attend.

When to Use

• Date pickers - Populate a calendar or slot selector on the tour page
• Availability checks - Confirm a tour runs on the user's travel dates
• Booking flow - Gate the checkout path until a valid slot is selected

What You Get

• Available dates - Days the tour can be booked
• Time slots - Start times per date where applicable
• Capacity hints - Whether slots are still bookable

Quick Start

Provide the tour id in the URL path and the required language query parameter.

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.

{
  "data": {
    "tourId": 903304,
    "participantsRange": {
      "min": 1,
      "max": 15
    },
    "categories": [
      {
        "ticketCategory": "adult",
        "name": "Adult",
        "ageRange": {
          "min": 18,
          "max": 99
        },
        "independentlyBookable": true
      }
    ],
    "addons": [
      {
        "id": 10,
        "name": "Audio guide",
        "maxQuantity": 5
      }
    ],
    "availableDates": [
      {
        "date": "2026-07-18"
      }
    ],
    "updateTimestamp": "2026-07-01T12:00:00Z"
  }
}