Hotel API · Getting started
Changelog
Revision history of the specification, newest first.
| Date | Author | Changes |
|---|---|---|
| 07/10/2026 | Mohamed Amine Balti | Add the OnlyBestPriceCombination filter to HotelSearchREQ — returns only the cheapest available offer combination per hotel |
| 21/09/2026 | Mohamed Amine Balti | Added GSC to HotelQuoteRES — the affiliate's general sales conditions in the language of the request, B2C API only. |
| 28/07/2026 | Wassim Ghliss | Add TariffNotes to HotelSearchRES at the <Hotel> node level. |
| 17/01/2026 | Wassim Ghliss | Add FromCache node to API HotelSearchREQ. |
| 13/01/2026 | Wassim Ghliss | Add Codepromo node to API HotelQuoteREQ. |
| 15/09/2025 | Ibtissem Amama | Update the description of the Nationality node in HotelQuoteREQ |
| 13/09/2025 | Ibtissem Amama | Update the description of the Nationality node in HotelSearchREQ |
| 10/09/2025 | Ibtissem Amama | Add OnlyAvailable node to API HotelQuoteREQ |
| 25/06/2025 | Mohamed Amine Balti | Add HotelCollect to HotelBookingCreationREQ |
| 30/05/2025 | Wassim Ghliss | Introducing Timeout for HotelSearch API, = 10000ms by default, added to HotelSearchREQ |
| 06/05/2025 | Ismail Khessib | Add Nationality node to API HotelQuoteREQ |
| 11/03/2025 | Nesrine Bradai | Add Geolocation to the filter of HotelSearchREQ |
| 27/01/2025 | Mohamed Amine Balti | Add release date and min_stay to updateRooms |
| 15/01/2025 | Wassim Ghliss | Add support to filter Nationality in HotelSearch/HotelBookingCreation APIs |
| 16/12/2024 | Wassim Ghliss | Add Recommandation node to API HotelBookingCreationREQ under SelectedRoom |
| 16/12/2024 | Wassim Ghliss | Add Infant support in HotelSearch, HotelQuote, HotelBookingCreation APIs |
| 06/12/2024 | Ibtissem AMAMA | Add City and Destination to HotelQuoteRES |
| 05/11/2024 | Syrine Laabidi | The 'Facilities' tag is returned in StaticDataRS and provides a list of all facilities. |
| 04/11/2024 | Wassim Ghliss | Starting from V2025.x /cr.ws is migrated from .NET 4.8.1 to .NET8 and become /cr.ws.core SOAP protocol will be deprecated on 12/31/2026 and replaced by only REST GET/POST |
| 04/11/2024 | Ismail Khessib | Add new API: updateRooms() |
| 26/10/2024 | Mohamed Amine Balti | Add 'IdCity' to StaticDataRQ which enables filtering hotels by IdCity (optional). |
| 08/08/2024 | Ibtissem Amama | Add the OnRequestOk state to the states returned by the BookingListRS. |
| 06/08/2024 | Ibtissem Amama | Add API HotelBookingOnRequestCreationREQ to confirm the OnRequest Booking accepted by the Hotel |
| 31/07/2024 | Ibtissem Amama | Add HCN to HotelBookingAcknowledgeRQ to update HCN value (optional) |
| 30/07/2024 | Ibtissem Amama | Add TariffNotes to HotelSearchREQ to return TarifNotes in the HotelSearchRES if true (optional) |
| 16/05/2024 | Nesrine Bradai | Add “onlyavailable” to HotelBookingCreationREQ that gives distributor control to make booking creation fail if offer is no more available (optional). |
| 15/04/2024 | Ismail Khessib | Add HotelSearchCalendar api Add HotelQuoteMultiOffer api |
| 03/03/2024 | Ismail Khessib | HotelQuoteRES: Add "OfferId" attribute to <boarding> node, that specifies the offer identifier for some 3rd party suppliers HotelBookingREQ: Add <OfferId> node. It must be passed if it is returned in HotelSearchRES or HotelQuoteRES HotelBookingRES: Add "OfferId" attribute to <OrderDetails> node, that specifies the offer identifier for some 3rd party suppliers |
| 04/01/2024 | Yasmine Nasfi | Add FixedSalesDates <FixedSalesDates > for hotels with Category is FixedSalesDates in RES of StaticData / HotelDetail. |
| 04/01/2024 | Yasmine Nasfi | HotelSearchRES: Add "OfferId" attribute to <boarding> node, that specifies the offer identifier for some 3rd party suppliers HotelQuoteREQ: Add <OfferId> node. It must be passed if it is returned in HotelSearchRES |
| 26/10/2023 | Ibtissem Ammama | Add <c> to HotelSearchRES if results is coming from cache |
| 04/08/2023 | Slim Hajjami | Add fromdate todate nodes in API bookingList Request |
| 04/08/2023 | Slim Hajjami | Update response of BookingList which provides now ClientTel, ClientEmail, Autorisation, PaidAmount |
| 24/01/2023 | Yasmine Nasfi | Update supplements nodes in RES of HotelSearch / HotelQuote / HotelBookingCreation to support multiple supplements |
| 28/12/2022 | Yasmine Nasfi | HotelSearch / HotelQuote / HotelBookingCreation : add nodes <TariffNotes> to display any comment about the related rate like "You will pay upon arrival a tax charge of XXX for the YY night(s)" or if NRF: "This booking is non-refundable"..etc. |
| 13/04/2022 | Ismail Khessib | add <SourceGlobalSupplement> HotelSearchRES and HotelQuoteRES applicable only for a hotel with <source> node (3rd party). This is a handling booking fee |
| 15/12/2021 | Haifa Mamlouk | Add HotelTitle node and titles for the SelectedRoom and Boarding for B2C mode with <source> |
| 09/12/2021 | Haifa Mamlouk | Add HCN node in the BookingListRES |
| 18/11/2021 | Ahlem Trabelsi | Add a NetRate node in HotelBookingCreationRES |
| 04/11/2021 | Akrem Rouis | Add Id attribute to Room node in HotelQuoteREQ to identify which rooms are selected |
| 03/11/2021 | Ahlem Trabelsi | Add PaymentModes node to the HotelQuoteRES in B2C API |
| 03/11/2021 | Ahlem Trabelsi | Add PaymentMode node in HotelBookingCreationRES & HotelBookingCreationREQ |
| 19/10/2021 | Mohamed Ali Mejri | Add Child maxage & minage nodes to the StaticDataREQ |
| 01/09/2021 | Mohamed Ali Mejri | Add HotelDescriptionList & HotelRoomsDescriptionList nodes to HotelDetail response |
| 02/06/2021 | Imed Gharsalli | Add Timeout node to HotelSearchREQ |
| 23/03/2021 | Akrem Rouis | Add Count attribute in HotelQuoteRES Add Id attribute in HotelQuoteRES |
| 17/02/2021 | Sofiene Ouelhazi | SecurityCode node name fixed in HotelBookingCreationREQ |
| 08/02/2021 | Akrem Rouis | Add Cancellation Fee node in HotelSearchRES |
| 08/12/2020 | Achraf Bouanani | Updated HotelSearch() API the system no longer returns the global cancellation conditions in the HotelSearchRES as it was incorrect information. Only CancellationPolicy for each room is now returned. |
| 13/11/2020 | Achraf Bouanani | Updated HotelRoomSelection() API added new node <Image> to the response |
| 12/10/2020 | Imed Gharsalli | Added new API HotelStopSale() |
| 02/10/2020 | Sofien Ouelhazi | HotelSearch: add <Summary> node to the HotelSearchRES response |
| 11/08/2020 | Achraf Bouanani | moved CancellationPolicy inside every boarding offer in HotelSearch() API. |
| 21/07/2020 | Achraf Bouanani | Added new node <WithoutNRF> to HotelSearch() API request. |
| 16/07/2020 | Achraf Bouanani | Added new node <HotelCheckinStartingDate> to HotelBookingCreation() API response when online express check-in is supported. |
| 08/06/2020 | Achraf Bouanani | Added new node <HotelCheckinUrl> to HotelBookingCreation() API response when online express check-in is supported |
| 13/01/2020 | Achraf Bouanani | Updated StaticDataRQ() API added new nodes in <hotel> |
| 04/01/2020 | Sofiene Ouelhazi | Updated HotelBookingCreationREQ() add new nodes in <PaymentDetails> Updated HotelBookingCreationRES() add new nodes in <PaymentDetails> |
| 25/12/2019 | Akrem Rouis | Add new node <NonRefundable> to HotelSearch() and HotelCancellationPolicy() APIs |
| 09/10/2019 | Mohamed Ali Mejri | update BookingList() and HotelBookingCreation() APIs parameters descriptions |
| 04/07/2019 | Abderraouf Hatmi | add API HotelRoomSelection |
| 04/07/2019 | Abderraouf Hatmi | update API HotelSearchREQ: add new nodes to filter results based on hotels ids: hotels_ids or exclude_hotels_ids |
| 04/07/2019 | Imed Gharsalli | update API HotelSearchREQ: return mandatory supplements in <room> when applicable |
| 03/07/2019 | Imed Gharsalli | add attribute tolerance to expectedprice in HotelBookingCreation API update state node with id attribute in BookingList API |
| 20/05/2019 | Sofien Ouelhazi | update API BookingListRS ()Add new node PaidAmount. |
| 21/03/2019 | Sofien Ouelhazi | update API StaticDataRQ() Add new node rooms. |
| 28/10/2018 | Abderraouf Hatmi | HotelSearch: add <source> node to the response envelope HotelBookingCreation: add<source> node to the request envelope HotelDetail: add <source> node to the request envelope HotelCancellationPolicy: add <source> node to the request envelope HotelBookingCancellation: add<source> node to the request envelope |
| 22/10/2018 | Malek Bessrour | Add attribute ‘IdToken’ to child node In HotelBookingCreationRQ |
| 22/10/2018 | Malek Bessrour | Add attribute ‘IdToken’ to child node In BookingListRQ |
| 22/10/2018 | Malek Bessrour | Add attribute ‘IdMember’ to child node in TripBookingListRQ |
| 06/04/2018 | Chaima Mekni | Add attribute ‘age’ to Child node in HotelCancellationPolicyREQ |
| 09/03/2018 | Chaima Mekni | Add new node ‘expectedprice’ to HotelBookingCreationREQ |
| 08/03/2018 | Chaima Mekni | Add information about age node to HotelBookingCreationREQ |
| 21/12/2017 | Chaima Mekni | Add new API HotelBookingAcknowledge |
| 06/12/2017 | Chaima Mekni | Add attribute ‘age’ to Child node in HotelSearchREQ Add attribute ‘age’ to Child node in HotelSearchRES |
| 07/06/2017 | Chaima Mekni | HotelBookingAcknowledge Edit HotelSearchRES API: Change attribute ‘agemax’ to ‘maxage’ Change attribute ‘agemin’ to ‘minage’ |
| 16/05/2017 | Abdelhedi Neffati | Add CreditCheck() API |
| 05/04/2017 | Abdelhedi Neffati | Add Api TripBookingList API |
| 15/07/2016 | Chaima Mekni | Add new nodes Passenger:Age and Passenger:Reduction to HotelBookingCreationREQ |
| 10/06/2016 | Chaima Mekni | Add new node Kit:PaymentGateway to HotelBookingCreationREQ Delete nodes PaymentMode, Kit:Status, Kit:ErrorType, Kit:ErrorNumber and Kit:ErrorText from HotelBookingCreationREQ |
| 08/06/2016 | Chaima Mekni | Add node Summary to HotelDetailRS |
| 03/06/2016 | Chaima Mekni | 1.Add node Kit in HotelBookingCreationREQ only for B2C and Available booking 2.Delete node SelectedRooms:Options:Option:@id from HotelBookingCreationREQ 3.Add node Options to SaticData API 4. Add node Options to HotelDetail API |
| 02/06/2016 | Ismail Diari | Update HotelBookingCreationRES : - Add Multi CancellationPolicies - Add Fee node under CancellationPolicy node - Delete currency attribute - Add NoShowPolicy Node - Delete ConfirmationDetails node - Move CancellationPolicies under OrderDetails node - Add password attribute to OrderDetails node - Delete CancellationRules node |
| 02/06/2016 | Ismail Diari | Add New API HotelCancellationPolicy |
| 02/06/2016 | Chaima Mekni | Add node Customer in HotelBookingCreationREQ |
| 14/04/2016 | Ismail Diari | Add node Category in HotelBookingCreationRES |
| 25/03/2016 | Ghada Saihi | Add nodes in HotelBookingCreationRES |
| 04/12/2015 | Ismail Diari | Add Details for Available node in HotelSearchRES |
| 03/09/2015 | Chaima Mekni | Edit HotelSearchRES |
| 26/08/2015 | Chaima Mekni | Add APIs StaticDataRQ and HotelDetatilRQ |
| 03/04/2015 | Ismail Diari | Document creation |