# Find an activity

Status: pre-launch. Open-source self-hosted version and Ancilair Cloud are coming; join the waitlist at https://ancilair.com/#waitlist.

Tours and activities from suppliers that sell them through a partner API. The routed ids are anc.activity.search, then anc.activity.book.

A search is not a booking. If the confirmed price differs from the search, stop and show the new price. That price still needs a yes.

Routed: `anc.activity.search, then anc.activity.book`.

The price is quoted on the call, at the supplier's rate, with 0% markup. This page does not publish a rate card.

The open-source, self-hosted version is coming. Contact: https://ancilair.com/contact

## What's the best way to ask?

Coming soon. Contact: https://ancilair.com/contact

- One token. Supplier credentials stay on the server.
- The price is the quote on the call, at the supplier's rate, with 0% markup.
- A quote, a search, a plan list, or a requirements check is not a booking. The follow-up runs only after an explicit yes, with an Idempotency-Key.
- Name a supplier (civitatis.activity.search, getyourguide.activity.search, viator.activity.search, or klook.activity.search) when that supplier is the only one that should run. GetYourGuide booking runs only when the token's access includes booking. Viator booking runs only when the key's access includes it. Klook's published docs do not describe a search or a booking of Klook activities. That integration is on request.

## Suppliers

### Civitatis

B2B API for activities. Search by destination, zone, coordinates, or text. The calendar is the availability. A cart, then confirm, books it. Username and password return the token for later calls.

- `civitatis.activity.search` — Destination, zone, coordinates, or a text query. The calendar call is the availability. A search is not a booking.
- `civitatis.activity.book` — The activity, date, rate, and party, on a cart, then confirm. If the price changed, confirm returns that and does not charge. Idempotency-Key required.

### GetYourGuide

Partner API for tours. An access token in the X-ACCESS-TOKEN header. Search returns tours. Availability and a price breakdown are separate calls. Creating the booking needs booking access on that token.

- `getyourguide.activity.search` — A query or a place, and dates if the traveller named them. Returns tours. A search is not a booking.
- `getyourguide.activity.book` — The tour option the traveller accepted, after availability and the price breakdown. Only when the token's access includes booking. Idempotency-Key required.

### Viator (Tripadvisor)

Partner API for tours and experiences. An API key in the exp-api-key header. Product search returns summaries. An availability check is the price for a date and a party. Booking runs only when that key's access includes it.

- `viator.activity.search` — A destination or a text query, and dates if the traveller named them. Returns product summaries. A search is not a booking.
- `viator.activity.book` — The product the traveller accepted, after an availability check for that date and party. Only when the key's access includes booking. Idempotency-Key required.

### Klook

Tours and activities. The published Open API is a supplier connection: the supplier hosts the endpoints, and Klook calls them. It does not document a search or a booking of Klook activities. Integration is on request.

- `klook.activity.search` — On request. The published Open API does not document a search of Klook activities.
- `klook.activity.book` — On request. The published Open API does not document a booking of Klook activities. Idempotency-Key required.