### Booking Detail Request Example Source: https://developer.hotelbeds.com/documentation/transfers/booking-api/booking-post-booking/booking-detail This example demonstrates how to make a GET request to retrieve booking details using the booking reference and language. ```bash GET https://api.test.hotelbeds.com/transfer-api/1.0/bookings/_{{language}}_ /reference/_{{booking_reference}}_ ``` -------------------------------- ### Booking List Request Example Source: https://developer.hotelbeds.com/documentation/transfers/booking-api/booking-post-booking/booking-list This example demonstrates how to make a GET request to the booking list endpoint to retrieve bookings within a specified date range. Ensure the date range does not exceed 31 days. ```http GET https://api.test.hotelbeds.com/transfer-api/1.0/bookings/_en_?fromDate=_2020-12-01_ &toDate=_2020-12-20_ &dateType=_FROM_DATE_ &offset=_1_ &limit= _100_ ``` -------------------------------- ### Simple Content Request Example Source: https://developer.hotelbeds.com/documentation/activities/content-api/content-simple-and-multi-request Demonstrates a GET request to retrieve the content factsheet for a specific activity and modality. Ensure the language, activity code, and modality code are correctly specified. ```HTTP GET https://api.hotelbeds.com/activity-content-api/3.0/activities/en/E-E10-000200515/8 ``` -------------------------------- ### Get Boards List (JSON Response Sample) Source: https://developer.hotelbeds.com/documentation/hotels/content-api/api-reference Example of a successful JSON response when requesting the list of available board types. Includes audit data and board details. ```json { "auditData": { "environment": [ "awseuwest1", "awseuwest1b", "ip_10_185_91_142" ], "processTime": "53", "release": "19117e1a462f1a1d7fa2fcf6371e3bbdb0c14a89", "requestHost": "10.185.84.47", "serverId": "ip-10-185-91-142.eu-west-1.compute.internal.node.int-hbg-aws-eu-west-1.discovery", "timestamp": "2020-03-03 13:22:20.821" }, "boards": [ { "code": "AI", "description": { "content": "string", "languageCode": "string" }, "multiLingualCode": "AI" } ], "from": 0, "to": 0, "total": 0 } ``` -------------------------------- ### Activity Segments Example Source: https://developer.hotelbeds.com/documentation/activities/content-api/segments Example of activity segments with their codes and names. ```json { "code": 922, "name": "Urban Adventures" } ``` ```json { "code": 954, "name": "Landsea Tours" } ``` ```json { "code": 924, "name": "Gray Line" } ``` ```json { "code": 925, "name": "Lip Smacking Tours" } ``` ```json { "code": 926, "name": "Premium Tours" } ``` ```json { "code": 927, "name": "Walks of Paris" } ``` -------------------------------- ### Get Hotel Changes Request Payload Source: https://developer.hotelbeds.com/documentation/hotels/cds-api/cds-api-reference Example request payload for retrieving hotel changes. Specify the maximum number of hotel-day pairs, the starting point for changes, the stay date range, and a list of hotel identifiers. ```json { "maxHotelDayPairs": 100, "changesFrom": "2026-03-16T09:43:34.875", "stayDateRange": { "from": "2026-01-01", "to": "2026-12-28" }, "hotels": [ 4492, 49472 ] } ``` -------------------------------- ### Currencies Request Example Source: https://developer.hotelbeds.com/documentation/transfers/content-api/masters/currencies Example of a GET request to the Currencies API to retrieve all fields for currencies in English. ```HTTP https://api.hotelbeds.com/transfer-cache-api/1.0/currencies?fields=ALL&language=en ``` -------------------------------- ### SIIN Inventory with Release and Allotment Example Source: https://developer.hotelbeds.com/documentation/hotels/cache-api/external-inventory-process Example demonstrating release min/max days and allotment for a booking period. It illustrates how release dates affect booking confirmation windows. ```text 20201201:20201231:DBL:2Q::(2,30,5)(2,30,5)(5,60,5) ``` -------------------------------- ### Example Request for Destinations Source: https://developer.hotelbeds.com/documentation/activities/content-api/destinations An example of a GET request to the destinations endpoint for Spain, specifying the English language. ```HTTP https://api.test.hotelbeds.com/activity-content-api/3.0/destinations/en/ES ``` -------------------------------- ### Access FULL Resource with Java Source: https://developer.hotelbeds.com/documentation/hotels/cache-api/operations Example of how to access the FULL resource using Java's HttpClient. Requires username and password credentials. ```java HttpClient client = new HttpClient(); GetMethod method = new GetMethod("https://aif2.hotelbeds.com/aif2-pub-ws/files/full"); method.addRequestHeader("X-Username","myUserCredential"); method.addRequestHeader("X-Password","myPassCredential"); // Execute the HTTP GET request int status = client.executeMethod(method); if (status == 200){ // Get the file as InputStream InputStream in = method.getResponseBodyAsStream(); // Your process... } ``` -------------------------------- ### Countries Request Example Source: https://developer.hotelbeds.com/documentation/transfers/content-api/locations/countries Example of a GET request to the Countries endpoint. Specify fields, language, and optionally country codes, offset, and limit. ```http https://api.hotelbeds.com/transfer-cache-api/1.0/locations/countries?fields=ALL&language=en&codes=ES,US&offset=0&limit=10 ``` -------------------------------- ### Terminals Request Example Source: https://developer.hotelbeds.com/documentation/transfers/content-api/locations/terminals This example demonstrates how to request terminal information, specifying all fields, a language, and a list of terminal codes. ```HTTP https://api.hotelbeds.com/transfer-cache-api/1.0/locations/terminals?fields=ALL&language=es&codes=MAD,BCN,PMI ``` -------------------------------- ### Full Search Request Example Source: https://developer.hotelbeds.com/documentation/activities/booking-api/availability/search A complete example of a search request, including filters, date range, language, pagination, and order parameters. This shows how all components are structured together. ```json { "filters": [ { "searchFilterItems": [ {"type": "destination", "value": "PMI"} ] } ], "from": "2020-05-20", "to": "2020-05-30", "language": "en", "pagination": { "itemsPerPage": 99, "page": 1 }, "order": "DEFAULT" } ``` -------------------------------- ### Master TransferTypes Request Example Source: https://developer.hotelbeds.com/documentation/transfers/content-api/masters/transfer-types Example of a GET request to retrieve all transfer types in English. Ensure the 'fields' and 'language' parameters are correctly set. ```http https://api.hotelbeds.com/transfer-cache-api/1.0/ masters/transferTypes?fields=ALL&language=en ``` -------------------------------- ### Get Available Rooms Response Sample Source: https://developer.hotelbeds.com/documentation/hotels/content-api/api-reference Example JSON response for the 'Get Available Rooms' endpoint. This includes audit data and a list of rooms with their characteristics and descriptions. ```json { "auditData": { "environment": [ "awseuwest1", "awseuwest1b", "ip_10_185_91_142" ], "processTime": "53", "release": "19117e1a462f1a1d7fa2fcf6371e3bbdb0c14a89", "requestHost": "10.185.84.47", "serverId": "ip-10-185-91-142.eu-west-1.compute.internal.node.int-hbg-aws-eu-west-1.discovery", "timestamp": "2020-03-03 13:22:20.821" }, "from": 0, "rooms": [ { "characteristic": "ST", "characteristicDescription": { "content": "string", "languageCode": "string" }, "code": "DBL.ST", "description": "DOUBLE STANDARD", "maxAdults": 4, "maxChildren": 2, "maxPax": 4, "minAdults": 1, "minPax": 1, "type": "DBL", "typeDescription": { "content": "string", "languageCode": "string" } } ], "to": 0, "total": 0 } ``` -------------------------------- ### Initial Availability Request Example Source: https://developer.hotelbeds.com/documentation/hotels/knowledge-base/certification-process A basic availability request structure. This example specifies the source market, stay dates, and hotel IDs. ```json { "sourceMarket": "UK", "stay": { "checkIn": "2020-06-15", "checkOut": "2020-06-16" }, "occupancies": [ { "rooms": 1, "adults": 2, "children": 0 } ], "hotels": { "hotel": [ 1067, 1070, [...] 1074 ] } } ``` -------------------------------- ### Room with Multiple RoomStays (Apartment Example) Source: https://developer.hotelbeds.com/documentation/hotels/content-api/roomstays-logic-within-room This snippet illustrates a room with multiple roomStays, demonstrating the 'AND' logic for combined room configurations. It includes different types of room stays like 'BED' and 'LIV' with specific facilities. ```xml APARTMENT CAPACITY 6 TWO BEDROOMS ... Double bed 131-150 width Single bed 90-130 width Sofa bed ``` -------------------------------- ### Destinations API Request Example Source: https://developer.hotelbeds.com/documentation/transfers/content-api/locations/destinations Example of a GET request to the Destinations API. Specify fields, language, and optionally country codes, destination codes, offset, and limit. ```http https://api.hotelbeds.com/transfer-cache-api/1.0/locations/destinations?fields=ALL&language=es&countryCodes=ES&codes=MAD,BCN,PMI ``` -------------------------------- ### Redeem Information Examples Source: https://developer.hotelbeds.com/documentation/activities/knowledge-base/activities-content-redesign-actred Examples demonstrating different types of redeem information, including PRINTED, NONE, EVOUCHER, and VOCUHERLESS. ```json "redeemInfo": { "type": "PRINTED", "directEntrance": false, "comments": [ { "description": "Printed Voucher. Print and bring the voucher to enjoy the activity." } ] } ``` ```json "redeemInfo": { "type": "NONE", "directEntrance": false, "comments": [ { "description": "Voucherless. You don’t need to bring any voucher (digital or printed)!" } ] } ``` ```json "redeemInfo": { "type": "EVOUCHER", "directEntrance": false, "comments": [ { "description": "E-voucher. Show the voucher on your mobile device to enjoy the activity." } ] } ``` ```json "redeemInfo": { "type": "VOCUHERLESS", "directEntrance": false, "comments": [ { "description": "Printed voucher or E-voucher. Print and bring the voucher or show the voucher on your mobile device to enjoy the activity." } ] } ``` -------------------------------- ### Master Vehicles Request Example Source: https://developer.hotelbeds.com/documentation/transfers/content-api/masters/vehicles This example demonstrates a GET request to the /masters/vehicles endpoint to retrieve a portfolio of master vehicles. It includes mandatory parameters like 'fields' and 'language', and optional parameters such as 'codes', 'offset', and 'limit'. ```HTTP GET https://api.hotelbeds.com/transfer-cache-api/1.0/masters/vehicles?fields=_ {{FIELDS}}& language=_ {{LANG}}& codes=_ {{CODES}}& offset=_ {{OFFSET}}& limit=_ {{LIMIT}} ``` -------------------------------- ### Get Currencies List (JSON) Source: https://developer.hotelbeds.com/documentation/hotels/content-api/api-reference Retrieves a list of available currencies. This example shows the JSON response structure for a successful request. ```json { "auditData": { "environment": [ "awseuwest1", "awseuwest1b", "ip_10_185_91_142" ], "processTime": "53", "release": "19117e1a462f1a1d7fa2fcf6371e3bbdb0c14a89", "requestHost": "10.185.84.47", "serverId": "ip-10-185-91-142.eu-west-1.compute.internal.node.int-hbg-aws-eu-west-1.discovery", "timestamp": "2020-03-03 13:22:20.821" }, "currencies": [ { "code": "AED", "currencyType": "LIBERATE", "description": { "content": "string", "languageCode": "string" } } ], "from": 0, "to": 0, "total": 0 } ``` -------------------------------- ### Sample Booking Response 1 Source: https://developer.hotelbeds.com/documentation/hotels/booking-api/api-reference Example of a confirmed booking with specific room details, rates, and invoice information. ```json { "reference": "1-3815155", "clientReference": "AgencyTest03", "creationDate": "2018-03-20", "status": "CONFIRMED", "creationUser": "6j486qn8u3l8443sdb7nmhli", "holder": { "name": "CHARLES", "surname": "CALTHROP" }, "hotel": { "checkOut": "2018-07-27", "checkIn": "2018-07-21", "code": 4848, "name": "Grupotel Orient", "destinationCode": "PMI", "rooms": [ { "status": "CONFIRMED", "code": "DBT.ST", "paxes": [ { "roomId": 1, "type": "AD" }, { "roomId": 1, "type": "AD" } ], "rates": [ { "amount": "759.36", "paymentType": "AT_WEB", "boardCode": "FB", "rooms": 1 } ] } ] }, "invoiceCompany": { "code": "E14", "company": "HOTELBEDS S.L.U.", "registrationNumber": "ESB57218372" }, "totalSellingRate": 759.36, "totalNet": 759.36, "pendingAmount": 0, "currency": "EUR" } ``` -------------------------------- ### Booking Confirm API Request Example Source: https://developer.hotelbeds.com/documentation/activities/booking-api/booking-and-post-booking/booking-confirm This example demonstrates a typical request to the Booking Confirm API. It includes the necessary rateKey, selected dates, and personal information for the booking holder and passengers. ```json { "holder": { "firstName": "John", "lastName": "Doe", "emails": { "typeCode": "CORRECT", "email": "john.doe@example.com" }, "phones": { "typeCode": "CORRECT", "number": "123456789", "countryCode": "34" } }, "paxes": [ { "firstName": "John", "lastName": "Doe", "emails": { "typeCode": "CORRECT", "email": "john.doe@example.com" }, "phones": { "typeCode": "CORRECT", "number": "123456789", "countryCode": "34" } } ], "rateKey": "20231115103059-a0b1c2d3e4f5-a0b1c2d3e4f5-a0b1c2d3e4f5-a0b1c2d3e4f5", "productId": "10000001", "bookingDate": { "from": "2024-01-15", "to": "2024-01-15" }, "clientReference": "TEST-12345" } ``` -------------------------------- ### Get Classifications Response Sample (JSON) Source: https://developer.hotelbeds.com/documentation/hotels/content-api/api-reference Example of a successful JSON response when retrieving classifications. Includes audit data and a list of classification objects. ```json { "auditData": { "environment": [ "awseuwest1", "awseuwest1b", "ip_10_185_91_142" ], "processTime": "53", "release": "19117e1a462f1a1d7fa2fcf6371e3bbdb0c14a89", "requestHost": "10.185.84.47", "serverId": "ip-10-185-91-142.eu-west-1.compute.internal.node.int-hbg-aws-eu-west-1.discovery", "timestamp": "2020-03-03 13:22:20.821" }, "classifications": [ { "code": "NRF", "description": { "content": "string", "languageCode": "string" } } ], "from": 0, "to": 0, "total": 0 } ``` -------------------------------- ### Room with Standard RoomStay Example Source: https://developer.hotelbeds.com/documentation/hotels/content-api/roomstays-logic-within-room This snippet shows a room with a single roomStay, detailing its type, facilities, and descriptions. It serves as a basic example for understanding roomStay structure. ```xml QUADRUPLE STANDARD ... Double bed 131-150 width Queen-size bed 150-154 width ``` -------------------------------- ### Get Terminals JSON Response Sample Source: https://developer.hotelbeds.com/documentation/hotels/content-api/api-reference Example of a successful JSON response when retrieving terminal data. Includes audit information and a list of terminals with their details. ```json { "auditData": { "environment": [ "awseuwest1", "awseuwest1b", "ip_10_185_91_142" ], "processTime": "53", "release": "19117e1a462f1a1d7fa2fcf6371e3bbdb0c14a89", "requestHost": "10.185.84.47", "serverId": "ip-10-185-91-142.eu-west-1.compute.internal.node.int-hbg-aws-eu-west-1.discovery", "timestamp": "2020-03-03 13:22:20.821" }, "from": 0, "terminals": [ { "code": "PMI", "country": "ES", "description": { "content": "string", "languageCode": "string" }, "name": { "content": "string", "languageCode": "string" }, "type": "A" } ], "to": 0, "total": 0 } ``` -------------------------------- ### Get Segments Response Sample (JSON) Source: https://developer.hotelbeds.com/documentation/hotels/content-api/api-reference Example of a successful JSON response when retrieving segments. This includes audit data and a list of segments with their codes and descriptions. ```json { "auditData": { "environment": [ "awseuwest1", "awseuwest1b", "ip_10_185_91_142" ], "processTime": "53", "release": "19117e1a462f1a1d7fa2fcf6371e3bbdb0c14a89", "requestHost": "10.185.84.47", "serverId": "ip-10-185-91-142.eu-west-1.compute.internal.node.int-hbg-aws-eu-west-1.discovery", "timestamp": "2020-03-03 13:22:20.821" }, "from": 0, "segments": [ { "code": 0, "description": { "content": "string", "languageCode": "string" } } ], "to": 0, "total": 0 } ```