Change Log

# New Features For technical details, such as sample output for each feature, please view the [technical documentation](chttps://developers.booking.com/api/technical.html?). # Version 2.5 ## Tagging Deals in the API This feature enables an identifier in the output of availability endpoints. This identifier specifies the public price (the non-discounted rack rate), the discount percentage, and the name of the deal. Sample: ``` "deal_tagging": { "discount_percentage": 20, "deal_name": "Sales Campaigns", "public_price": 100.1 } ``` Please reach out to your dedicated account manager to enable the feature. ## /hotels * It is now possible to filter out properties based on the property type by adding **“hotel_type_ids”** in the request. Use the numeric id codes returned by **/hotelTypes** endpoint in the **“hotel_type_ids”** input. * Added **“hotel_description_formatted”** in the **“extras”** input parameter to be able to include line breaks in the **‘hotel_description’** output field. * To support bed configuration mapping for multiple bedrooms, **"bed_configurations"** has been moved inside **"bedrooms"**, and **"configuration_id"** has been removed. ## /processBooking Starting in September 2019, the EU will impose new requirements for authenticating online payments as part of the second Payment Services Directive (PSD2). Six (6) additional input parameters are now added for Strong Card Authentication (SCA) processing: * *sca_authentication_response* * *sca_cavv* * *sca_directory_response* * *sca_trans_id* * *sca_eci* * *sca_version* This development is only relevant to properties with the Exclusive and Hybrid Payment by Booking payment methods. ## /bookingDetails * It is now possible to display total transaction value (TTV) as an output. This value will display in the same currency the partner set for invoicing. * Two (2) fields have been added in the output: **“guest_price_local”** **“guest_price_euro”** These fields identify the total cost incurred for the guest(s) in both the property's local currency and in Euros. # Version 2.4  ## ## /bookingDetails - The output field **stay_probability** has been added when the account has this output field enabled. - The output **rres_id** (room reservation id) has been added to the **rooms** object. ## ## Reservation Modification Endpoints - It is now possible to modify a reservation when an account has these endpoints enabled: **/canChangeHotelReservation**, **/changeHotelReservation**, **/canChangeRoomReservation**, **/changeRoomReservation**, and **/changeBooking**. - These endpoints enable the modification of one or more of the following: check-in/check-out dates, guest name, number of guests, smoking preference, and (virtual) credit card. ## # Version 2.3 ## ## /avRooms - Output is now customisable through the parameters **min_length_of_stay** and **max_length_of_stay** and option **show_cheapest_block_only**. ## ## /blockAvailability and /hotelAvailability - Availability can be queried up to 500 days into the future. ## ## /hotels - Added **email** to `hotel_data`. ## # Version 2.2 ## ## /hotels - Added **license_number** as a separate field in `hotel_data`. - Added **auto_tags** to `hotel_photos` object and `room_photos` object. - The output field **bed_configurations** is now available when **room_info** is passed to the **extras** parameter. - It is now possible to retrieve key collection data by passing **key_collection_info** to the **extras** parameter. ## ## /hotelAvailability - The output field **cheapest_breakfast_rate** is now available when **add_cheapest_breakfast_rate** is passed to the **extras** parameter. ## ## /blockAvailability - Added **license_number** as a separate field to block level object. ## ## /bookingDetails - Added **price_local** output field. This represents the total reservation cost in the local currency of the property. - It is now possible to retrieve key collection data by passing **key_collection_info** to the **extras** parameter. ## ## /reviews - It is now possible to pull reviews in all available languages by passing **all** to the **language** parameter. ## # Version 2.1  ## ## /blockAvailability - Added **lunch_included** and **dinner_included** to block-level object. - The output field **hotel_url** has been added. - The output field **mealplan_description** is now provided when **mealplans** is passed to the **extras** parameter. ## ## /hotelAvailability - It is now possible to filter for properties that can be booked without a credit card by using **option=no_cc_filter**. ## ## ## /bookingDetails - Added to output: - Returns a list of rooms booked for each reservation. - Returns a breakdown of reservation charges. ## ## /processBooking - Added the new parameter **guest_emails**, which accepts a comma-separated list of emails, similar to **guest_names**. ## ## /autocomplete - Two-character inputs are now supported. ## ## /hotels - Hotel themes can now be provided in the output. ## ## All endpoints - RUIDs are now provided in both JSON and XML responses/output. ## ## Multiple endpoints - Language configuration for es-ar: Argentinian Spanish (es-ar) has been added to the list of permissible languages in the API.