Documentation

Introduction

APItude also includes now the ability to book activities.

This API suite will provide you with availability for tickets and excursions and allow you to distribute those not only through the websites but also is thought to support mobile and tablets.

APItude for Activities API suite is designed to provide Hotelbeds Group clients with a set of API calls to:


  • Enable the construction or creation of a complete activities website or mobile application (app)
  • Integrate activities products into existing systems both internal and external.
  • Integrate activities contents for activities into a common CMS for all the products being distributed.

The API is divided into the following sections:

  • Activities Booking API: Provides all the needed calls (operations) to develop your booking funnel, from availability to confirm a booking and obtain the all relevant information for a customers.

  • Activities Contents API: In case you want to cache, it provides activities factsheet content as well as API code mappings (countires, destinations, segmens and much more).

  • Activities Cache API: Provides activities portfolio and basic information as price from, modalities,operational dates and more.

APItude for Activities is delivered via HTTPS requests. Request and response data can be in either XML or JSON (preferred) allowing you to easily build requests and parse responses in a standard way by using the tools included with most of the modern languages.

We really recommend downloading the postman collection so you can easily test and see many examples, you can download the collection here.

Remenber that depending of the environment you want to use the hostname changes:

For TEST environment:

POST https://api.test.hotelbeds.com/....

For LIVE environment:

POST https://api.hotelbeds.com/....


IMPORTANT: For those who have already implemented the shopping cart in previous versions of our API (XML2) you will see a big difference and this is that there is no shopping cart concept present today. The shopping cart shall be managed by you since the API does not have it.

Since we would like to provide you with help and guidance on how to best use the APItude for activities we suggest you look at the different alternatives on how to use it towards better aligning to your booking funnel. Go here for more information.

We have been working towards making the complete process of integration easier and smoother. For that, we have created a set of tools that we offer to you during the complete life cycle of the implementation. These are the tools available for you at no cost!

  • The complete set of certification specifications which are online and available at any time, from anywhere
  • Examples for you to understand how a booking funnel should look like.
  • An ApiKey needed to authenticate to our API.
  • Our expert team not only in the integrations process but also in the activities product.
  • FAQ: Will help with most common doubts and will be dynamically updated.

We are also working on different versions of SDK that will be delivered progressively and that will be open source.