---
title: "Get tour availability"
method: GET
path: "/experiences/tours/{id}/availability"
tags: ["Tours"]
---

# Get tour availability

`GET /experiences/tours/{id}/availability`

## Request

- Base URL: `https://api.liteapi.travel/v3.0`
- URL: `https://api.liteapi.travel/v3.0/experiences/tours/{id}/availability`
- Auth: API key in header `X-API-Key`

## 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.

| Code | Meaning |
| --- | --- |
| 71001 | invalid experience request |
| 71002 | experience not found |
| 71003 | experiences provider request failed |
| 71004 | experiences provider request timed out |
| 71005 | experience request is unauthorized |
| 71006 | experience request is forbidden |
| 71007 | experiences service is temporarily unavailable |
| 71099 | failed to retrieve experiences |

## Path parameters

- `id` string, required

## Query parameters

- `language` string, required

## Response `200`

Tour availability, participant ranges, and add-ons

- TourAvailabilityEnvelope
  - `data` TourAvailabilityResponse, required
    - `tourId` integer
    - `participantsRange` AvailabilityParticipantsRangeResponse
      - `min` integer
      - `max` integer
    - `categories` AvailabilityTicketCategoryResponse[]
      - `ticketCategory` string: Key to use in `booking-options` `participants`.
      - `name` string
      - `ageRange` AvailabilityAgeRangeResponse
        - `min` integer
        - `max` integer
      - `independentlyBookable` boolean: Whether this category can be booked without an adult present.
    - `addons` AvailabilityAddonResponse[]
      - `id` integer
      - `name` string
      - `maxQuantity` integer
    - `availableDates` AvailabilityDateResponse[]
      - `date` string, date
      - `hasDeal` boolean
    - `updateTimestamp` string, date-time

## Other responses

- `400`: Invalid discovery query, tour id or booking-options input. Code 71001.
- `401`: Authentication failed. Shared API-key middleware uses code 401; product handlers can use their operation-specific unauthorized code listed on the endpoint.
- `403`: Access denied. Shared access middleware uses common codes; product-specific forbidden codes are listed on the endpoint.
- `404`: Tour or requested discovery resource not found. Code 71002.
- `429`: Shared Dispatcher request limit exceeded. Code 4290; this is not an Experiences operation code.
- `500`: Discovery operation failed. Code 71099. Shared middleware can return other common codes.
- `502`: Experiences discovery dependency failed. Code 71003.
- `503`: Experiences discovery is temporarily unavailable. Code 71007.
- `504`: Experiences discovery dependency timed out. Code 71004.

---

[API](https://skmtc.dev/liteapi/apis/api-experiences.md) - [All operations](https://skmtc.dev/liteapi/apis/api-experiences/llms.txt) - [OpenAPI document](https://skmtc.dev/liteapi/apis/api-experiences/revisions/40074513d3a2?raw)