Activities API

Tours, attractions, and experiences

Browse a catalogue, check availability by date and timeslot, book, and hand over a voucher. One REST flow, prices in USD.

GET /Activity/v2/products
GET /Activity/v2/products
  ?city=Tbilisi
  &sort=bestselling
  &per_page=20
Overview

Activity content is deep and availability is time sensitive. This activities API gives you a searchable catalogue, per-date and per-timeslot availability with past times filtered out, a simple booking flow, and downloadable vouchers.

The tours and activities API wraps a deep catalogue of experiences with real, time-aware availability. Categories, languages, durations, price tiers, and per-timeslot inventory are unified into one flow, so you can sell a walking tour or a day trip with the same code path you already use for flights and hotels.

What you get

1

Search the catalogue by city, category, price, and language.

2

Read bookable dates and timeslots, already filtered against the activity's local time.

3

Create a booking, confirm it, and download the voucher.

4

Availability is filtered against each activity's local time, so past slots never show.

5

Downloadable vouchers and a booking-status event you can subscribe to instead of polling.

How the flow works

01

Browse

Search the catalogue by city, category, price, or language.

02

Availability

Read bookable dates, then timeslots for a chosen date.

03

Book

Create a booking for a product-type and traveller mix.

04

Voucher

Confirm and download the voucher, or watch the status event.

Key endpoints

GET/Activity/v2/productsSearch the activity catalogue.
GET/Activity/v2/availability/datesList bookable dates for a product.
GET/Activity/v2/availability/timeslotsList timeslots for a chosen date.
POST/Activity/v2/bookingsCreate a booking.
GET/Activity/v2/bookings/{id}/voucherDownload the voucher.

Request and response

Request · GET /Activity/v2/products
GET /Activity/v2/products
  ?city=Tbilisi
  &sort=bestselling
  &per_page=20
Response · 200 OK
{
  "products": [
    {
      "productId": "ACT-4410",
      "title": "Old Town Walking Tour",
      "durationMinutes": 120,
      "from": { "amount": 29.00, "currency": "USD" },
      "productTypes": [
        { "code": "ADULT", "label": "Adult ticket" }
      ]
    }
  ]
}

What the response includes

productId
Stable id for the activity.
productTypes
Bookable variants, such as ticket tiers or packages.
from
Lead-in price, in USD.
durationMinutes
Length of the experience.
cancellationPolicy
Free-cancellation window, if any.
2,500+

Activities across the world's destinations

Frequently asked questions

How is availability returned?

As bookable dates, and as timeslots for a chosen date. Anything already in the past is removed against the activity's local time.

What is a product-type?

A bookable variant of a product, such as a ticket tier or a package. You book by its id.

When can I get the voucher?

Once the booking is issued. You can watch the booking-status event instead of polling.

How do product-types work?

A product-type is a bookable variant, such as an adult ticket or a package. You book by its code together with the traveller mix.

Can I get live booking status?

Yes. Subscribe to the booking-status event and receive the voucher as soon as the booking is issued, with no polling.

Build your travel product on one API.

Free to integrate. 1% per issued ticket, capped at $10. Live coverage across flights, hotels, and activities.