Skip to content

Developer Guide - Retrieve Rooms and Rates API

What is the Retrieve Rooms and Rates API?

Kurzurlaub.de uses e.g. OTA_HotelAvailRQ/RS and various other OTA messages, to transfer a list of active rooms and offers/prices for a hotel from the booking channel page.

This service is used by the broadcaster's hoteliers to set up their rooms in Back end. Rooms returned by the service must be active in the channel for hoteliers to manage updates.

Optionally all bookable additional services (e.g. 20 min massage for the price of 19.50 euros) can also be called up.

Two Types of Retrieve Rooms and Rates

The first question should always be:

Let's use only

  1. Get room data only
  2. Retrieve room data and offer/rate data

This also forms the basis of the 2nd part for sending availability at room level and/or room/rate level in part Inventory Push API

1. Retrieve room data and rate data

If your channel supports both room types and rate plans, please use the Get Room and Rate Codes message.

If your backend supports availability at room level and offer level - i.e. room types and rate plans (so-called RoomType/RatePlan combinations), please use the messages to "retrieve room data and rate data"

2. Retrieve room data only

If your backend only supports room-level based availabilities - i.e. only room types (RoomType) and no rate plans, please use the "retrieve room data only" messages

Retrieval of bookable additional benefits / services

Optionally, all bookable additional benefits / services (e.g. 20 minute massage for the price of 19.50 euros) can also be called up. This is done using the method OTA_HotelDescriptiveInfoRQ and must be requested in advance from the Kurzurlaub.de Connectivity Team.

Overview of available messages

Overview of available messages - official OTA Messages - for retrieving room dates / rates / offer information and prices