Booking
The Booking operation requests a reservation confirmation for the specified ratekey or ratekeys.
BookingAPI does not support on-request confirmations. All confirmations are instant confirmations.
Booking Request
Endpoint
Please take into account that at the booking step the endpoint is different between bookings with payment details (for AT_HOTEL rates) and without payment details (for AT_WEB rates).
When sending credit card details:
When NOT sending credit card details:
Holder and pax names
The booking holder’s name and surname are mandatory. Regarding the passenger names we recommend at least one adult name (and surname) per room. Please remember that some destinations (for example Las Vegas or some cities in Russia) require all the names to avoid check in problems.
Request parameters
Node/Attribute |
Value |
Description |
bookingRQ |
Element |
Top level |
bookingRQ/@language |
String |
Response language |
bookingRQ/holder |
Element |
Booking holder information element |
bookingRQ/holder/@name |
String |
Booking holder name for all the rooms of the booking (max length = 50 characters) |
bookingRQ/holder/@surname |
String |
Booking holder surname for all rooms of the booking (max length = 50 characters) |
bookingRQ/rooms |
Array of room elements |
List of the rooms to be confirmed |
bookingRQ/rooms/room |
Element |
Room to be confirmed |
bookingRQ/rooms/room/@rateKey |
String |
Rate key to be confirmed taken from the previous step |
bookingRQ/rooms/room/paxes |
Array of pax elements |
List of paxes for the room |
bookingRQ/rooms/room/paxes/pax |
Element |
Element that describes pax information |
bookingRQ/rooms/room/paxes/pax/@roomId |
Int |
Room where the pax is located |
bookingRQ/rooms/room/paxes/pax/@type |
String |
Pax type Two values are permitted for the attribute:
|
bookingRQ/rooms/room/paxes/pax/@name |
String |
Pax name (max length = 50 characters) |
bookingRQ/rooms/room/paxes/pax/@surname |
String |
Pax surname (max length = 50 characters) |
bookingRQ/clientReference |
String |
Your internal booking reference |
bookingRQ/remark | String | Free comments text that is sent to the hotelier. It can be used to request or inform of special requests to hotelier like: “Non-smoking room preferred”, “Twin bed please”, “Upper floor preferred”, “Late arrival”…. NOTE: The character limit in this field is 2000 characters. |
bookingRQ/tolerance |
Double |
Margin of price difference (as percentage) accepted when a price difference occurs between Availability/CheckRate and Booking operations. This overrides the default tolerance of 2%. Do not use more than two decimal characters when defining tolerance. Example: to input a tolerance of 5%, you should input 5.00. NOTE: Check with your sales manager before using this tag. |
bookingRQ/paymentData |
Element |
Payment information. NOTE: This node must be used if paymentType='AT_HOTEL', only the pay at hotel model (liberate) uses payment data nodes. For other pricing models, these node must not be used. |
bookingRQ/paymentData/paymentCard |
Element |
Credit card information |
bookingRQ/paymentData/paymentCard/cardType |
String |
Credit card type
|
bookingRQ/paymentData/paymentCard/cardHolderName | String | Credit card holder |
bookingRQ/paymentData/paymentCard/cardNumber |
Int |
Credit card number |
bookingRQ/paymentData/paymentCard/expiryDate |
Int |
Credit card expiration date |
bookingRQ/paymentData/paymentCard/cardCVC |
Int |
Credit card CVC security code |
bookingRQ/paymentData/contactData |
Element |
Contact data of the holder |
bookingRQ/paymentData/contactData/email |
String |
Customer e-mail |
bookingRQ/paymentData/contactData/phoneNumber |
String |
Customer phone number |
Request XML Example
<bookingRQ xmlns="http://www.hotelbeds.com/schemas/messages" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <holder name="Holder Name" surname="Holder Surname"/> <rooms> <room rateKey="126177|SGL-E10|CG-MERCHANT|1|ST|BB-E10||1~1~0|20150427#1033102103"> <paxes> <pax roomId=1 type="AD" name="Adult Name" surname="Adult Surname"/> </paxes> </room> </rooms> <paymentData> <paymentCard> <cardHolderName>Holder name</cardHolderName> <cardType>VI</cardType> <cardNumber>4444333322221111</cardNumber> <expiryDate>0615</expiryDate> <cardCVC>123</cardCVC> </paymentCard> <contactData> <email>integration@test.com</email> <phoneNumber>654654654</phoneNumber> </contactData> </paymentData> <clientReference>My booking reference</clientReference> <remark>Booking remarks are to be written here.</remark> <tolerance>2.00</tolerance> </bookingRQ>
Request JSON Example
{ "holder": { "name": "IntegrationTestFirstName", "surname": "IntegrationTestLastName" }, "rooms": [{ "rateKey": "20160628|20160702|W|102|569|TPL.ST|CG-OPAQUE|RO||1~1~2|11~11|N@1816912017", "paxes": [{ "roomId": "1", "type": "AD", "name": "First Adult Name", "surname": "Surname" }, { "roomId": "1", "type": "CH", "name": "First Child Name", "surname": "Surname" }, { "roomId": "1", "type": "CH", "name": "First Child Name", "surname": "Surname" }] }], "clientReference": "IntegrationAgency", "remark": "Booking remarks are to be written here.", "tolerance" : 2.00 }
Examples
Here You can find additional request examples for some of the uses of the Booking operation in both XML and JSON:
Bookings with multiple rooms of the same type
To book multiple rooms of the same type you just have to add the additional pax elements while increasing the roomId attribute for the passengers of each subsequent room. This is done to assign this extra passengers (for which there would normally be no space) to additional rooms of the same type.
You can observe this in the below example. The room type being booked is a Double Standard, with room for two passengers. The two first passengers are assigned to the first room with roomId = 1, and the two additional passengers are assigned to a second room of the same type, with roomId = 2.
XML
<bookingRQ xmlns="http://www.hotelbeds.com/schemas/messages" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <holder name="IntegrationTestFirstName" surname="IntegrationTestLastName"/> <clientReference>IntegrationAgency</clientReference> <rooms> <room rateKey="20180708|20180709|W|1|1070|DBT.ST|NRF- MERCHANT|BB||2~2~0||N@7D54E8910CD145D1528444426321AAES00000120002000207210120"> <paxes> <pax roomId="1" type="AD" name="First Adult Name"/> <pax roomId="1" type="AD" name="Second Adult Name"/> <pax roomId="2" type="AD" name="Thid Adult Name"/> <pax roomId="2" type="AD" name="Fourth Adult Name"/> </paxes> </room> </rooms> <remark>Booking remarks are to be written here.</remark> <tolerance>2.00</tolerance> </bookingRQ>
JSON
{ "holder": { "name": "IntegrationTestFirstName", "surname": "IntegrationTestLastName" }, "rooms": [{ "rateKey": "20180708|20180709|W|1|1070|DBT.ST|NRF- MERCHANT|BB||2~2~0||N@7D54E8910CD145D1528444426321AAES00000120002000207210120", "paxes": [{ "roomId": "1", "type": "AD", "name": "First Adult Name" }, { "roomId": "1", "type": "AD", "name": "Second Adult Name" }, { "roomId": "2", "type": "AD", "name": "Third Adult Name" }, { "roomId": "2", "type": "AD", "name": "Fourth Adult Name" }] }], "clientReference": "IntegrationAgency", "remark": "Booking remarks are to be written here.", "tolerance" : 2.00 }
Bookings with multiple rooms of different type
In order to book multiple rooms of different type you just have to add as many room elements as rooms you want to book, with their corresponding rateKeys and the appropriate pax elements for each room.
This structure can also be used to book multiple rooms of the same type if you use the same rateKey, but will result in bigger requests in size.
XML
<bookingRQ xmlns="http://www.hotelbeds.com/schemas/messages" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <holder name="IntegrationTestFirstName" surname="IntegrationTestLastName"/> <clientReference>IntegrationAgency</clientReference> <rooms> <room rateKey="20180708|20180709|W|1|1070|DBT.ST|NRF- MERCHANT|BB||1~2~0||N@9F3C3CAC02ED4D01528443411841AAES000000800020002071890"> <paxes> <pax roomId="1" type="AD" name="First Adult Name" surname="Surname"/> <pax roomId="1" type="AD" name="Second Adult Name" surname="Surname"/> </paxes> </room> <room rateKey="20180708|20180709|W|1|1070|JSU.ST|NRF- MERCHANT|HB||1~1~1|2|N@9F3C3CAC02ED4D01528443411841AAES0000008000200020722de7"> <paxes> <pax roomId="1" type="AD" name="Third Adult Name" surname="Surname"/> <pax roomId="1" type="CH" name="First Child Name" surname="Surname"/> </paxes> </room> </rooms> <remark>Booking remarks are to be written here.</remark> <tolerance>2.00</tolerance> </bookingRQ>
JSON
{ "holder": { "name": "IntegrationTestFirstName", "surname": "IntegrationTestLastName" }, "rooms": [{ "rateKey": "20180708|20180709|W|1|1070|DBT.ST|NRF- MERCHANT|BB||1~2~0||N@9F3C3CAC02ED4D01528443411841AAES000000800020002071890", "paxes": [{ "roomId": 1, "type": "AD", "name": "First Adult Name", "surname": "Surname" }, { "roomId": 1, "type": "AD", "name": "Second Adult Name", "surname": "Surname" }] }, { "rateKey": "20180708|20180709|W|1|1070|JSU.ST|NRF- MERCHANT|HB||1~1~1|2|N@9F3C3CAC02ED4D01528443411841AAES0000008000200020722de7", "paxes": [{ "roomId": 1, "type": "AD", "name": "Third Adult Name", "surname": "Surname" }, { "roomId": 1, "type": "CH", "name": "First Child Name" }] }], "clientReference": "IntegrationAgency", "remark": "Booking remarks are to be written here.", "tolerance" : 2.00 }
Booking Response
When the confirmation of a rateKey is successful; the booking reference is provided, along with key information of the booking, which includes:
- Hotel confirmed
- Holder and pax confirmed
- Rate confirmed with the confirmed amounts and dates
The response also contains the price breakdown, cancellation policies, supplements, and discounts.
Please make sure to keep the booking reference of all bookings performed with your credentials, as they are needed for post booking operations such as modification or cancellation.
Response parameters
Node/Attribute |
Type |
Description |
bookingRS |
Element |
Top Element |
bookingRS/auditData |
Element |
Relevant internal information |
bookingRS/auditData/@processTime |
Float |
Server process time in milliseconds |
bookingRS/auditData/@timestamp |
Date |
Date/time when the requests have been processed |
bookingRS/auditData/@requestHost | String | IP address of the system host |
bookingRS/auditData/@serverId |
String |
Server code or ID (for internal use) |
bookingRS/auditData/@environment |
String |
Environment where the request has been sent and processed |
bookingRS/auditData/@release | String | Release version identifier |
bookingRS/auditData/@token | String | Token identifier of the operation |
bookingRS/auditData/@internal | String | Internal identifier of the parameters of the operation |
bookingRS/booking |
Element |
Element that contains the information of the booking |
bookingRS/booking/@reference |
String |
Booking reference Format: XXX-XXXXXX |
bookingRS/booking/@clientReference |
String |
Client internal booking reference |
bookingRS/booking/@creationDate |
Date |
Booking creation date Format: YYYY-MM-DD |
bookingRS/booking/@status |
String |
Booking status:
|
bookingRS/booking/@creationUser | String | apiKey used to make the booking |
bookingRS/booking/@totalNet |
Float |
Total amount of the booking |
bookingRS/booking/@pendingAmount | Float | Remaining amount to be paid |
bookingRS/booking/@currency |
String |
Currency of the amount to be paid |
bookingRS/booking/modificationPolicies | Element | Information regarding the allowed modifications to the booking |
bookingRS/booking/modificationPolicies/@cancellation | Boolean | Indicates if the booking can be cancelled |
bookingRS/booking/modificationPolicies/@modification | Boolean | Indicates if the booking can be modified |
bookingRS/booking/holder | Element | Information of the booking holder |
bookingRS/booking/holder/@name | String | Booking holder name |
bookingRS/booking/holder/@surname | String | Booking holder surname |
bookingRS/booking/hotel |
Element |
Element that contains information about the hotel and associated rates |
bookingRS/booking/hotel/@checkOut | Date |
Check-out date Format: YYYY-MM-DD |
bookingRS/booking/hotel/@checkIn | Date |
Check-in date Format: YYYY-MM-DD |
bookingRS/booking/hotel/@code | Int |
Hotebeds internal hotel code |
bookingRS/booking/hotel/@name |
String |
Hotel name |
bookingRS/booking/hotel/@categoryCode |
String |
Hotel category code |
bookingRS/booking/hotel/@categoryName |
String |
Category name |
bookingRS/booking/hotel/@destinationCode |
String |
Destination code for hotel location |
bookingRS/booking/hotel/@destinationName |
String |
Destination name for hotel location |
bookingRS/booking/hotel/@zoneCode |
Int |
Zone code for hotel location |
bookingRS/booking/hotel/@zoneName |
String |
Zone name for hotel location |
bookingRS/booking/hotel/@latitude |
Float |
Latitude data for geolocation |
bookingRS/booking/hotel/@longitude |
Float |
Longitude data for geolocation |
bookingRS/booking/hotel/@totalSellingRate | Float | Total amount of the booking in hotelCurrency (for the pay at hotel model |
bookingRS/booking/hotel/@totalNet | Float | Total amount of the booking |
bookingRS/booking/hotel/@currency |
String |
Client currency |
bookingRS/booking/hotel/rooms |
Array of room elements |
List of rooms booked for the hotel of the reservation |
bookingRS/booking/hotel/rooms/room |
Element |
Element that contains information about the room and associated rates |
bookingRS/booking/hotel/rooms/room/@status |
String |
Room booking status:
|
bookingRS/booking/hotel/rooms/room/@id | Int | Room reservation identifier |
bookingRS/booking/hotel/rooms/room/@code |
Int |
Internal room code |
bookingRS/booking/hotel/rooms/room/@name |
String |
Room name/description |
bookingRS/booking/hotel/rooms/room/@supplierReference |
String |
Booking reference of the booking/room for external product supplier bookings |
bookingRS/booking/hotel/rooms/room/paxes | Array of pax elements | List of paxes for the room |
bookingRS/booking/hotel/rooms/room/paxes/pax | Element | Element that describes passenger information |
bookingRS/booking/hotel/rooms/room/paxes/pax/@roomId | Int | Room where the pax is located |
bookingRS/booking/hotel/rooms/room/paxes/pax/@type | String |
Pax type Two values are permitted for the attribute:
|
bookingRS/booking/hotel/rooms/room/paxes/pax/@age | Int | Pax age |
bookingRS/booking/hotel/rooms/room/paxes/pax/@name | String | Pax name |
bookingRS/booking/hotel/rooms/room/paxes/pax/@surname | String | Pax surname |
bookingRS/booking/hotel/rooms/room/rates |
Array of rate elements |
List of rates for a particular hotel |
bookingRS/booking/hotel/rooms/room/rates/rate |
Element |
Price information for a room type and board |
bookingRS/booking/hotel/rooms/room/rates/rate/@rateClass |
String |
Internal rate class type (NOR, NRF, SPE, OFE, PAQ...) |
bookingRS/booking/hotel/rooms/room/rates/rate/@net | Float | Room net price |
bookingRS/booking/hotel/rooms/room/rates/rate/@rateComments | String | Rate comments that contain important information (max length = 4000 characters) |
bookingRS/booking/hotel/rooms/room/rates/rate/@paymentType |
String |
Identifies if it is pay at hotel or merchant |
bookingRS/booking/hotel/rooms/room/rates/rate/@packaging |
String |
Identifies if the rate is for packaging |
bookingRS/booking/hotel/rooms/room/rates/rate/@boardCode |
String |
Internal board code |
bookingRS/booking/hotel/rooms/room/rates/rate/@boardName | String | Board name/description |
bookingRS/booking/hotel/rooms/room/rates/rate/@sellingRate |
Float |
Room gross price, if it is included |
bookingRS/booking/hotel/rooms/room/rates/rate/@commission |
Float |
Profit margin the agency takes (commissionable model) |
bookingRS/booking/hotel/rooms/room/rates/rate/@hotelSellingRate |
Float |
Room gross price in hotelCurrency (for the pay at hotel model) |
bookingRS/booking/hotel/rooms/room/rates/rate/@hotelCurrency |
String |
Hotel currency (for the pay at hotel model) |
bookingRS/booking/hotel/rooms/room/rates/rate/@hotelMandatory |
Boolean |
Identifies if the selling rate is recommended |
bookingRS/booking/hotel/rooms/room/rates/rate/@rooms |
Int |
Number of rooms requested with the same occupancy |
bookingRS/booking/hotel/rooms/room/rates/rate/@adults |
Int |
Number of adults requested per room |
bookingRS/booking/hotel/rooms/room/rates/rate/@children |
Int |
Number of children requested per room |
bookingRS/booking/hotel/rooms/room/rates/rate/cancellationPolicies |
Array of policies elements |
List of cancellation policies |
bookingRS/booking/hotel/rooms/room/rates/rate/cancellationPolicies/policy |
Element |
Cancellation policies |
bookingRS/booking/hotel/rooms/room/rates/rate/cancellationPolicies/policy/@amount |
Float |
Amount that will be charged after '@from' date |
bookingRS/booking/hotel/rooms/room/rates/rate/cancellationPolicies/policy/@from |
String |
Date from which the amount will be charged in ISO 8601 format (yyyy-MM-ddTHH:mm:ssZ) |
bookingRS/booking/hotel/rooms/room/rates/rate/cancellationPolicies/policy/@hotelAmount |
Float |
Amount that will be charged after '@from' date, provided in hotel currency (for the pay at hotel model) |
bookingRS/booking/hotel/rooms/room/rates/rate/cancellationPolicies/policy/@hotelCurrency |
String |
Currency in which the booking must be paid on arrival |
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown |
Element |
Rate breakdown element |
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/@commission |
Float |
Profit margin the agency takes (commissionable model) |
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/@commissionPCT |
Float |
Percentual share of the price corresponding to commision |
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/@commissionVAT |
Float |
Share of the commission corresponding to the Value Added Tax |
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateDiscounts | Array of rateDiscounts elements | List of discounts for a particular rate |
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateDiscounts/rateDiscount | Element | Discount element |
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateDiscounts/rateDiscount/@code | Int | Discount internal code |
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateDiscounts/rateDiscount/@name | String | Discount name/description |
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateDiscounts/rateDiscount/@amount | Float | Amount of the discount |
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateSupplements | Array of rateSupplements elements | List of supplements for a particular rate |
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateSupplements/rateSupplement | Element | Rate supplements element |
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateSupplements/rateSupplement/@code | Int | Supplement code |
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateSupplements/rateSupplement/@name | String | Supplement name |
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateSupplements/rateSupplement/@from | Date |
Date from when the supplement begins to apply |
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateSupplements/rateSupplement/@to | Date | Date that the supplement no longer applies |
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateSupplements/rateSupplement/@amount | Float | Supplement amount |
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateSupplements/rateSupplement/@nights |
Int |
Number of nights the supplement applies |
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateSupplements/rateSupplement/@paxNumber |
Int |
Number of paxes to whom the supplement applies |
bookingRS/booking/hotel/rooms/room/rates/rate/rateBreakDown/rateSupplements/rateSupplement/@paxType |
String |
Type of pax |
bookingRS/booking/hotel/rooms/room/rates/rate/taxes |
Array of tax elements |
List of prices with taxes included or excluded |
bookingRS/booking/hotel/rooms/room/rates/rate/taxes/@allIncluded |
Boolean |
Indicates if all taxes are included or not |
bookingRS/booking/hotel/rooms/room/rates/rate/taxes/tax |
Element |
Element that contains the information about the tax |
bookingRS/booking/hotel/rooms/room/rates/rate/taxes/tax/@included |
Boolean |
Indicates if the tax is included in the price or not |
bookingRS/booking/hotel/rooms/room/rates/rate/taxes/tax/@percent |
Float |
Value of the tax as a percentage |
bookingRS/booking/hotel/rooms/room/rates/rate/taxes/tax/@amount |
Float |
Value of the tax in hotel currency if the tax is not included in the price |
bookingRS/booking/hotel/rooms/room/rates/rate/taxes/tax/@currency |
String |
Currency of the tax amount |
bookingRS/booking/hotel/rooms/room/rates/rate/taxes/tax/@type |
String |
Type of the tax:
|
bookingRS/booking/hotel/rooms/room/rates/rate/taxes/tax/@clientAmount |
Float |
Net amount of the tax in the client configured currency, returned in case the currency of the hotel is different from the client currency |
bookingRS/booking/hotel/rooms/room/rates/rate/taxes/tax/@clientCurrency |
String |
Client configured currency in case the currency of the hotel is different from the client currency |
bookingRS/booking/hotel/supplier |
Element |
Element that contains supplier information |
bookingRS/booking/hotel/supplier/@name |
String |
Supplier name |
bookingRS/booking/hotel/supplier/@vatNumber |
String |
Supplier VAT number |
bookingRS/booking/invoiceCompany |
Element |
Element that contains information about the invoice company |
bookingRS/booking/invoiceCompany/@code |
String |
Code of the invoice company |
bookingRS/booking/invoiceCompany/@name |
String |
Name of the invoice company |
bookingRS/booking/invoiceCompany/@registrationNumber |
String |
Registration number of the invoice company |
bookingRS/booking/remark | String | Free comments text that is sent to the hotelier. It can be used to request or inform of special requests to hotelier like: “Non-smoking room preferred”, “Twin bed please”, “Upper floor preferred”, “Late arrival”…. NOTE: The character limit in this field is 2000 characters. |
Response XML Example
<?xml version="1.0" encoding="UTF-8"?> <bookingRS xmlns="http://www.hotelbeds.com/schemas/messages" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" schemaLocation="http://www.hotelbeds.com/schemas/messages"> <auditData processTime="1096" timestamp="2018-03-23 09:45:12.518" requestHost="212.66.164.12" serverId="sa3RKSJACHXE79K.env#PL" environment="[int]" release="5c2a98762e8da116cf86a57a17c9db9d2e4d80eb" token="6d71245c-dc5b-4a40-aab3-554b3ad8f7d5" internal="0|A8FAFF47CABB439894D7DF039FABE2260934|UK|07|16|354|||||||||11.26|C|R|311|1|1~1~2~0|0|8||3|wuupfvswdqfz342cejxfv3ku|||"/> <booking reference="1-3816249" clientReference="BRUNOTESTBOOKING" creationDate="2018-03-23" status="CONFIRMED" creationUser="wuupfvswdqfz342cejxfv3ku" totalNet="250.19" pendingAmount="250.19" currency="EUR"> <modificationPolicies cancellation="true" modification="true"/> <holder name="HOLDERFIRSTNAME" surname="HOLDERLASTNAME"/> <hotel checkOut="2018-04-24" checkIn="2018-04-23" code="229318" name="Hotel Hostal Cuba" categoryCode="4EST" categoryName="4 STARS" destinationCode="PMI" destinationName="Majorca" zoneCode="10" zoneName="Palma" latitude="39.570177" longitude="2.639077" totalNet="250.19" currency="EUR"> <rooms> <room status="CONFIRMED" id="1" code="JSU.ST" name="JUNIOR SUITE STANDARD" supplierReference="18431999M-MJ"> <paxes> <pax roomId="1" type="AD" name="Second Adult Name" surname="Surname"/> <pax roomId="1" type="AD" name="First Adult Name" surname="Surname"/> </paxes> <rates> <rate rateClass="NOR" net="250.19" sellingRate="280.00" hotelMandatory="true" rateComments="1x JUNIOR SUITE Estimated total amount of taxes & fees for this booking: 6.60 Euro payable on arrival 
. Car park NO . Key Collection 15:00 – . Check-in hour 15:00 – 00:00. No hen/stag or any other parties allowed – . " paymentType="AT_WEB" packaging="false" boardCode="BB" boardName="BED AND BREAKFAST" rooms="1" adults="2" children="0"> <cancellationPolicies> <cancellationPolicy amount="250.19" from="2018-04-19T23:59:00+02:00"/> </cancellationPolicies> <taxes allIncluded="false"> <tax included="false" amount="6.60" currency="EUR"/> </taxes> </rate> </rates> </room> </rooms> <supplier name="HOTELBEDS PRODUCT,S.L.U." vatNumber="ESB38877676"/> </hotel> <remark>Booking remarks are to be written here.</remark> <invoiceCompany code="E14" name="HOTELBEDS SPAIN, S.L.U" registrationNumber="ESB57218372"/> </booking> </bookingRS>
Response JSON Example
{ "auditData": { "processTime": "2083", "timestamp": "2018-03-23 09:35:20.383", "requestHost": "212.66.164.12", "serverId": "sa3RKSJACHXE79K.env#PL", "environment": "[int]", "release": "5c2a98762e8da116cf86a57a17c9db9d2e4d80eb", "token": "8d42450b-f463-4bc3-aae8-fc0b030c0e37", "internal": "0|A8FAFF47CABB439894D7DF039FABE2260934|UK|07|16|354|||||||||11.26|C|R|311|1|1~1~2~0|0|8||3|wuupfvswdqfz342cejxfv3ku|||" }, "booking": { "reference": "1-3816248", "clientReference": "BRUNOTESTBOOKING", "creationDate": "2018-03-23", "status": "CONFIRMED", "modificationPolicies": { "cancellation": true, "modification": true }, "creationUser": "wuupfvswdqfz342cejxfv3ku", "holder": { "name": "HOLDERFIRSTNAME", "surname": "HOLDERLASTNAME" }, "hotel": { "checkOut": "2018-04-24", "checkIn": "2018-04-23", "code": 229318, "name": "Hotel Hostal Cuba", "categoryCode": "4EST", "categoryName": "4 STARS", "destinationCode": "PMI", "destinationName": "Majorca", "zoneCode": 10, "zoneName": "Palma", "latitude": "39.570177", "longitude": "2.639077", "rooms": [{ "status": "CONFIRMED", "id": 1, "code": "JSU.ST", "name": "JUNIOR SUITE STANDARD", "supplierReference": "16923904M-MJ", "paxes": [{ "roomId": 1, "type": "AD", "name": "Second Adult Name", "surname": "Surname" }, { "roomId": 1, "type": "AD", "name": "First Adult Name", "surname": "Surname" }], "rates": [{ "rateClass": "NOR", "net": "250.19", "sellingRate": "280.00", "hotelMandatory": true, "rateComments": "1x JUNIOR SUITE Estimated total amount of taxes & fees for this booking: 6.60 Euro payable on arrival \r. Car park NO . Key Collection 15:00 – . Check-in hour 15:00 – 00:00. No hen/stag or any other parties allowed – . ", "paymentType": "AT_WEB", "packaging": false, "boardCode": "BB", "boardName": "BED AND BREAKFAST", "cancellationPolicies": [{ "amount": "250.19", "from": "2018-04-19T23:59:00+02:00" }], "taxes": { "taxes": [{ "included": false, "amount": "6.60", "currency": "EUR" }], "allIncluded": false }, "rooms": 1, "adults": 2, "children": 0 }] }], "totalNet": "250.19", "currency": "EUR", "supplier": { "name": "HOTELBEDS PRODUCT,S.L.U.", "vatNumber": "ESB38877676" } }, "remark": "Booking remarks are to be written here.", "invoiceCompany": { "code": "E14", "company": "HOTELBEDS SPAIN, S.L.U", "registrationNumber": "ESB57218372" }, "totalNet": 250.19, "pendingAmount": 250.19, "currency": "EUR" } }
Post Booking Operations
Once you have confirmed bookings, there's a series of operations that can be performed:
- BookingList: To retrieve a list of the performed bookings.
- BookingDetail: To retrieve the information of a specific booking.
- BookingChange: To update and modify a booking.
- BookingCancellation: To cancel a booking.
Bear in mind that except for BookingList you will need the booking reference of the bookings you carried out to perform this operations.
Docs Navigation
- GET AN API KEY AND AUTHENTIFICATION
- Hotel BOOKINGAPI
- Hotel CONTENTAPI
- Hotel CACHEAPI
- Hotel FEEDBACKAPI
- Hotel Endpoints and Headers
- Hotel API ERRORS
- Activities BOOKINGAPI
- Activities CONTENTAPI
- Activities API ERRORS
- Transfers BOOKINGAPI
- Transfers CACHEAPI
- Transfers API ERRORS