Getting Started with the Xeni Activities API
The Xeni Activities API gives you programmatic access to a global inventory of tours, attractions, transfers, and experiences. With a single integration, you can search destinations, browse activity categories, check real-time availability, and complete bookings entirely via API.
What You Can Do
The Activities API v1 supports the full booking lifecycle:
- Search destinations — Autocomplete city and destination names to retrieve destination IDs for downstream queries.
- Browse tags and categories — Retrieve available filter tags (e.g., Helicopter Tours, Day Cruises, Walking Tours) for any destination.
- Search activities — Query available activities with filters for price, duration, time of day, popularity, specials, and tags.
- Get activity details — Retrieve full activity information including descriptions, locations, available dates, and pricing.
- Check availability — View available product options with real-time pricing for specific dates and traveler counts.
- Book activities — Create bookings with traveler details, booking questions, and language guide preferences.
- Manage bookings — Retrieve booking details, check cancellation penalties, and process cancellations.
Integration Flow
A typical integration follows this sequence:
- Autocomplete a destination name to obtain a
destinationId. - Get tags for the destination to present filtering options to users.
- Search activities using the destination ID, tags, and other filters.
- Get details for a selected activity using its
productCode. - Check availability for the desired travel date and traveler mix.
- Book the activity by submitting traveler information and booking question answers.
- Retrieve or cancel the booking as needed.
Authentication
All requests to the Activities API require a valid API key passed in the request header:
| Header | Required | Description |
|---|---|---|
x-api-key | Yes | Your Xeni API key. |
Include this header on every request. If you do not have an API key, contact your Xeni account manager or reach out to customersupport@xeni.com.
Base URL
All activity endpoints use the following base path:
{{api_host}}/api/ext/activity/...
Replace {{api_host}} with the appropriate environment URL provided during onboarding.
Available Endpoints
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/ext/activity/destinations | Autocomplete destination names |
| GET | /api/ext/activity/tags | Get filter tags for a destination |
| POST | /api/ext/activity/search | Search activities with filters |
| GET | /api/ext/activity/details/{productCode} | Get activity details |
| POST | /api/ext/activity/availability | Check availability and pricing |
| POST | /api/ext/activity/booking | Book an activity |
| GET | /api/ext/activity/bookings/{bookingId} | Retrieve booking details |
| GET | /api/ext/activity/{bookingId}/cancel-penalty | Check cancellation penalty |
| POST | /api/ext/activity/cancel | Cancel a booking |
Next Steps
Start by searching for destinations using the autocomplete endpoint. See How to Search for Activity Destinations for a step-by-step walkthrough.