CheckBookings By Dates
Overview
The CheckBookings By Dates
operation allows clients to retrieve the status of bookings that fall within a specified date range. It provides a way to list multiple bookings based on criteria such as check-in dates or booking creation dates. This operation is optional but can significantly enhance the functionality of a Connector by providing bulk booking insights.
- Booking Retrieval by Date: Enables clients to fetch booking details for a given range of dates.
- Data Insights: Useful for operational analysis or customer service purposes, such as managing upcoming check-ins or tracking recent bookings.
- Supplier Compatibility: Adapts to suppliers that support range-based booking queries.
When to Use:
- Operational Monitoring: To track all bookings for a specific date range, such as upcoming arrivals.
- Bulk Booking Insights: To retrieve booking data for analysis or reporting purposes.
- Supplier-Specific Use Cases: When suppliers provide additional insights or booking details for specific date ranges.
Date Range Options:
- Check-in Date: Fetch bookings based on the guest's check-in date.
- Booking Date: Fetch bookings based on when the reservation was created in the supplier's system.
Note: This operation is not mandatory but is highly recommended for suppliers supporting this functionality, as it provides comprehensive booking management capabilities.
Common Scenarios:
- Upcoming Arrivals: Retrieve all bookings with check-ins scheduled for the upcoming week.
- Booking Analytics: Generate reports for all bookings made during a promotional period.
- Error Handling:
BookingNotFound
: No bookings found for the specified date range.SupplierError
: Indicates an issue with the supplier's API, such as unavailability or invalid date formats.
Request
Overview
The Request Object includes date range criteria and any supplier-specific fields.
Sample
- C#
- FormTest Sample JSON
var checkBookingsByDateRq = new CheckBookingsByDateRq
{
Input = new CheckBookingsByDateInput
{
CheckIn = "2024-05-12",
CheckOut = "2024-05-14",
DateType = "Arrival",
Language = "ES",
Currency = "EUR"
},
Settings = new Settings
{
Supplier = "HOTELTEST",
Platform = "HOTELTEST",
Client = "TravelAgency123",
Access = new Access
{
Code = 1001,
User = "agency_user",
Password = "secure_password",
ApiKey = "API_KEY_123456789",
Urls = new Urls
{
Book = "https://api.hotelsupplier.com/book",
Search = "https://api.hotelsupplier.com/search",
Quote = "https://api.hotelsupplier.com/quote",
Generic = "https://api.hotelsupplier.com/generic"
},
Parameters = new Dictionary<string, string>
{
{ "someParameter1", "50" },
{ "someParameter2", "true" },
{ "someParameter3", "5000" },
{ "someParameter4", "SupplierX" }
}
},
BusinessRules = new BusinessRules
{
OptionsQuota = 170,
BusinessRuleType = "CheaperAmount"
},
Timeout = "00:00:10",
TimeoutAsTimeSpan = TimeSpan.Parse("00:00:10"),
IncludeProviderTransactions = true
}
};
"checkBookingsByDateRq":
{
"input":
{
"checkIn": "2024-05-12",
"checkOut": "2024-05-14",
"dateType": "Arrival",
"language": "ES",
"currency": "EUR"
},
"settings":
{
"supplier": "HOTELTEST",
"platform": "HOTELTEST",
"client": "TravelAgency123",
"access":
{
"code": 1001,
"user": "agency_user",
"password": "secure_password",
"apiKey": "API_KEY_123456789",
"urls":
{
"book": "https://api.hotelsupplier.com/book",
"search": "https://api.hotelsupplier.com/search",
"quote": "https://api.hotelsupplier.com/quote",
"generic": "https://api.hotelsupplier.com/generic"
},
"parameters":
{
"someParameter1": "50",
"someParameter2": "true",
"someParameter3": "5000",
"someParameter4": "SupplierX"
}
},
"businessRules":
{
"optionsQuota": 170,
"businessRuleType": "CheaperAmount"
},
"timeout": "00:00:10",
"timeoutAsTimeSpan": "00:00:10",
"includeProviderTransactions": true
}
}
Details
Name | Relation | Type | Description |
---|---|---|---|
Settings | 1 | Settings | Contains the settings required for the check bookings request. |
Settings/Supplier | 1 | String | Identifies the supplier associated with the hotel operation. This is a unique code generated by Travelgate within its system to represent the supplier. |
Settings/Platform | 1 | String | Represents the platform on which the hotel operation is performed.Platforms are collections of suppliers, and the platform code is generated by Travelgate to define the operational context. |
Settings/Client | 1 | String | Represents the client performing the hotel operation.This is a unique client code assigned by Travelgate to identify the client within its system. |
Settings/Access | 1 | Access | Contains access information required for the operation, including API credentials, endpoints, and other connection details specific to the supplier's integration. |
Settings/Access/Code | 1 | Integer | The unique code identifying the access configuration. |
Settings/Access/User | 0 . . 1 | String | The username used for authentication with the supplier. |
Settings/Access/Password | 0 . . 1 | String | The password used for authentication with the supplier. |
Settings/Access/ApiKey | 0 . . 1 | String | The API key used for authentication or authorization. |
Settings/Access/Urls | 1 | Urls | The URLs associated with the access configuration. |
Settings/Access/Urls/Book | 0 . . 1 | String | The URL used for booking operations. |
Settings/Access/Urls/Search | 0 . . 1 | String | The URL used for Search operations. |
Settings/Access/Urls/Quote | 0 . . 1 | String | The URL used for Quote operations. |
Settings/Access/Urls/Generic | 0 . . 1 | String | A generic URL for additional operations. |
Settings/Access/Parameters | 0 . . 1 | AccessParameters | Additional parameters related to the connection. |
Settings/BusinessRules | 0 . . 1 | BusinessRules | Specifies the business rules to be applied during the operation. These rules define operational constraints and behavior, such as quota limits or prioritization criteria. |
Settings/BusinessRules/ OptionsQuota | 0 . . 1 | Integer | The maximum number of options returned for each board in the Search query. |
Settings/BusinessRules/ BusinessRuleType | 0 . . 1 | BusinessRulesType | The business rule type that determines how Search results are prioritized or filtered. |
Settings/Timeout | 1 | String | Defines the timeout period for the operation as a string value.This indicates the maximum amount of time to wait for a supplier's response before timing out.The value must be provided in timestamp format (e.g., "00:00:10" for 10 seconds). |
Settings/TimeoutAsTimeSpan | 0 . . 1 | String | Converts the timeout value from the string representation (Timeout) into a TimeSpan for use in time-based operations. |
Settings/ IncludeProviderTransactions | 1 | Boolean | Indicates whether detailed traces of provider transactions should be included in the operation's response.If enabled, the ProviderAudit field in responses will contain the transaction logs (e.g., requests and responses exchanged with the supplier). |
Input | 1 | CheckBookingsByDateInput | Contains the details for checking bookings within a specific date range. |
Input/CheckIn | 1 | String | The check-in date for the booking check, specified as a string. |
Input/CheckOut | 1 | String | The check-out date for the booking check, specified as a string. |
Input/CheckInAsDateTime | 0 . . 1 | String | The check-in date parsed as a DateTime object, expressed in UTC 0 |
Input/CheckOutAsDateTime | 0 . . 1 | String | The check-out date parsed as a DateTime object, expressed in UTC 0 |
Input/DateType | 1 | DateRangeType | Specifies the type of date range to use for the booking check. |
Input/Language | 0 . . 1 | String | The language code to be used for the booking check. |
Input/Currency | 0 . . 1 | Currency | The currency to be used for the booking check. |
Response
The Response Object provides a list of bookings within the specified date range, including their status, locators, and optional details.
Overview
- Booking Status: Indicates whether bookings are active, canceled, or unknown.
- Locators: Provides client and supplier locators for each booking.
- Optional Data:
- Guest details.
- Room information.
- Payment or cancellation status, depending on the supplier's capabilities.
Sample
- C#
- FormTest Sample JSON
var checkBookingsByDateRs = new CheckBookingsByDateRs
{
AuditData = new AuditData
{
Request = new List<Request>
{
new Request
{
Data = "<x>SupplierRequest</x>",
Headers = new Dictionary<string, string>
{
{ "Accept", "application/x-protobuf" },
{ "Accept-Encoding", "gzip,deflate," }
},
HttpMethod = new HttpMethod { Method = "POST" },
SendAt = DateTime.Parse("2025-03-16T08:21:49Z"),
Url = "http://travelgate.com"
}
},
Response = new List<Response>
{
new Response
{
Data = "<x>SupplierResponse</x>",
Headers = new Dictionary<string, string>
{
{ "Content-Encoding", "gzip," }
},
HttpMethod = new HttpMethod { Method = "POST" },
ReceivedAt = DateTime.Parse("2025-03-16T08:21:49Z"),
StatusCode = 200
}
}
},
AdviseMessages = new List<AdviseMessage>
{
new AdviseMessage
{
Code = "SupplierError",
Level = "Error",
Description = "Supplier error, check external for more details",
External = new External
{
Code = "Code123",
Message = "Supplier internal error",
HttpStatusCode = 200
}
}
},
Bookings = new List<Booking>
{
new Booking
{
Status = "Ok",
Reference = new Reference
{
ClientLocator = "ClientReference12345",
SupplierLocator = "SupplierLocator389b10ca-893b-4e7b-adf6-b067a1b1d9b3",
HotelLocator = "HotelLocator208c2b6f-1cdf-4204-9ebe-f147808218d9"
},
Holder = new Holder
{
Name = "John",
SurName = "Smith",
PersonalTitleType = "MR",
ContactInfo = new ContactInfo
{
Email = "someemail@travelgate.com",
Phone = "66666666"
}
},
Hotel = new Hotel
{
BookingDate = DateTime.Parse("2024-05-10"),
CheckIn = DateTime.Parse("2024-05-12"),
CheckOut = DateTime.Parse("2024-05-14"),
HotelCode = "12345",
HotelName = "Hotel Travelgate",
BoardCode = "RO",
Occupancies = new List<Occupancy>
{
new Occupancy
{
OccupancyId = 1,
Paxes = new List<Pax>
{
new Pax { Age = 30 },
new Pax { Age = 30 }
}
}
},
Rooms = new List<Room>
{
new Room
{
OccupancyRefId = 1,
Code = "DBL",
Description = "Double standard",
RoomPrice = new RoomPrice
{
Price = new Price
{
Currency = "EUR",
Binding = true,
Net = 100,
Gross = 100,
NetSpecified = true,
MinimumSellingPrice = 100
},
PriceBreakdown = new List<PriceBreakdown>
{
new PriceBreakdown
{
Price = new Price
{
Currency = "EUR",
Binding = true,
Net = 50,
Gross = 50,
NetSpecified = true,
MinimumSellingPrice = 50
},
Start = 0,
End = 1
},
new PriceBreakdown
{
Price = new Price
{
Currency = "EUR",
Binding = true,
Net = 50,
Gross = 50,
NetSpecified = true,
MinimumSellingPrice = 50
},
Start = 1,
End = 2
}
}
},
Refundable = true,
RefundableSpecified = false
}
}
},
Price = new Price
{
Currency = "EUR",
Binding = true,
Net = 100,
Gross = 100,
NetSpecified = true,
MinimumSellingPrice = 100
},
CancelPolicy = new CancelPolicy
{
RoomCancelPolicyDescriptions = new List<RoomCancelPolicyDescription>
{
new RoomCancelPolicyDescription
{
OccupancyRefId = 1,
Description = "Cancellations within 48 hours before check-in incur a 50% charge."
}
},
Refundable = false,
CancelPenalties = new List<CancelPenalty>
{
new CancelPenalty
{
HoursBefore = 48,
PenaltyType = "Percentage",
Currency = "EUR",
Value = 50,
Deadline = DateTime.Parse("2025-05-30T23:59:59Z")
}
},
CancelPolicyDescription = "50% charge if canceled within 48 hours before check-in."
},
Remarks = new List<Remark>
{
new Remark
{
RemarkType = "General",
Text = "CheckIn at 10:00 AM"
}
}
}
},
Parameters = new List<Parameter>
{
new Parameter
{
Key = 190,
Value = "Value81f30d88-28a1-46fc-bd49-f15e9e3448c0",
ParameterType = "Supplier",
Immutable = false,
RoomId = 32
}
},
AddOns = new Dictionary<string, string>
{
{ "keybd54429a-d5b4-40e4-9bbc-351520de3f96", "valuee436526f-b82e-4286-8351-dc345688bc6c" }
}
};
"checkBookingsByDateRs":
{
"auditData":
{
"request":
[
{
"data": "<x>SupplierRequest</x>",
"headers":
{
"Accept": "application/x-protobuf",
"Accept-Encoding": "gzip,deflate,"
},
"httpMethod":
{
"method": "POST"
},
"sendAt": "2025-03-16 08:21:49Z",
"url": "http://travelgate.com"
}
],
"response":
[
{
"data": "<x>SupplierResponse</x>",
"headers":
{
"Content-Encoding": "gzip,"
},
"httpMethod":
{
"method": "POST"
},
"receivedAt": "2025-03-16 08:21:49Z",
"statusCode": 200
}
]
},
"adviseMessages":
[
{
"code": "SupplierError",
"level": "Error",
"description": "Supplier error, check external for more details",
"external":
{
"code": "Code123",
"message": "Supplier internal error",
"httpStatusCode": 200
}
}
],
"bookings":
[
{
"status": "Ok",
"reference":
{
"clientLocator": "ClientReference12345",
"supplierLocator": "SupplierLocator389b10ca-893b-4e7b-adf6-b067a1b1d9b3",
"hotelLocator": "HotelLocator208c2b6f-1cdf-4204-9ebe-f147808218d9"
},
"holder":
{
"name": "John",
"surName": "Smith",
"personalTitleType": "MR",
"contactInfo":
{
"email": "someemail@travelgate.com",
"phone": "66666666"
}
},
"hotel":
{
"bookingDate": "2024-05-10",
"checkIn": "2024-05-12",
"checkOut": "2024-05-14",
"hotelCode": "12345",
"hotelName": "Hotel Travelgate",
"boardCode": "RO",
"occupancies":
[
{
"occupancyId": 1,
"paxes":
[
{
"age": 30
},
{
"age": 30
}
]
}
],
"rooms":
[
{
"occupancyRefId": 1,
"code": "DBL",
"description": "Double standard",
"roomPrice":
{
"price":
{
"currency": "EUR",
"binding": true,
"net": 100,
"gross": 100,
"netSpecified": true,
"minimumSellingPrice": 100
},
"priceBreakdown":
[
{
"price":
{
"currency": "EUR",
"binding": true,
"net": 50,
"gross": 50,
"netSpecified": true,
"minimumSellingPrice": 50
},
"start": 0,
"end": 1
},
{
"price":
{
"currency": "EUR",
"binding": true,
"net": 50,
"gross": 50,
"netSpecified": true,
"minimumSellingPrice": 50
},
"start": 1,
"end": 2
}
]
},
"refundable": true,
"refundableSpecified": false
}
]
},
"price":
{
"currency": "EUR",
"binding": true,
"net": 100,
"gross": 100,
"netSpecified": true,
"minimumSellingPrice": 100
},
"cancelPolicy":
{
"roomCancelPolicyDescriptions":
[
{
"occupancyRefId": 1,
"description": "Cancellations within 48 hours before check-in incur a 50% charge."
}
],
"refundable": false,
"cancelPenalties":
[
{
"hoursBefore": 48,
"penaltyType": "Percentage",
"currency": "EUR",
"value": 50,
"deadline": "2025-05-30T23:59:59Z"
}
],
"cancelPolicyDescription": "50% charge if canceled within 48 hours before check-in."
},
"remarks":
[
{
"remarkType": "General",
"text": "CheckIn at 10:00 AM"
}
]
}
],
"parameters":
[
{
"key": 190,
"value": "Value81f30d88-28a1-46fc-bd49-f15e9e3448c0",
"parameterType": "Supplier",
"immutable": false,
"roomId": 32
}
],
"addOns":
{
"keybd54429a-d5b4-40e4-9bbc-351520de3f96": "valuee436526f-b82e-4286-8351-dc345688bc6c"
}
}
Details
Name | Relation | Type | Description |
---|---|---|---|
AuditData | 1 | ProviderAudit | Provides detailed audit data for the supplier transactions, including request and response logs. |
AuditData/Request | 0 . . N | Array<ProviderAuditRq> | Collection of audit entries for provider requests.Each entry contains details about a specific request made to the provider. |
AuditData/Request/SendAt | 1 | String | The timestamp indicating when the request was sent. Date on UTC Standard (ISO 8601 UTC 2025-05-21T08:48:53.9744052+00:00 ) |
AuditData/Request/Data | 1 | String | The payload data included in the request. |
AuditData/Request/Url | 1 | String | The URL of the provider endpoint to which the request is sent. |
AuditData/Request/Headers | 1 | Object | A collection of headers included in the request. |
AuditData/Request/HttpMethod | 1 | HttpMethod | The HTTP method used to send the request. |
AuditData/Request/HttpMethod/ Method | 1 | String | No description available. |
AuditData/Response | 0 . . N | Array<ProviderAuditRs> | Collection of audit entries for provider responses.Each entry contains details about a specific response received from the provider. |
AuditData/Response/ReceivedAt | 1 | String | The timestamp indicating when the response was received. Date on UTC Standard (ISO 8601 UTC 2025-05-21T08:48:53.9744052+00:00 ) |
AuditData/Response/Data | 1 | String | The payload data contained in the provider's response. |
AuditData/Response/Headers | 1 | Object | A collection of headers included in the provider's response. |
AuditData/Response/StatusCode | 1 | Integer | The HTTP status code returned by the provider. |
AdviseMessages | 0 . . N | Array<AdviseMessage> | A collection of advice messages generated during the booking check operation. |
AdviseMessages/Code | 1 | AdviseMessageCode | Gets the code that represents the message type. |
AdviseMessages/Level | 1 | AdviseMessageLevel | Gets the severity level of the message (e.g., Error, Warning, or Info). |
AdviseMessages/Description | 1 | String | Gets the message description providing additional context. |
AdviseMessages/CorrelationId | 0 . . 1 | String | Gets a unique identifier for correlating the message with specific operations. |
AdviseMessages/External | 0 . . 1 | External | Gets additional external details associated with the message. |
AdviseMessages/External/Code | 1 | String | The supplier's internal code for identifying the nature of the response or error. |
AdviseMessages/External/ Message | 1 | String | A descriptive message returned by the supplier. |
AdviseMessages/External/ HttpStatusCode | 1 | Integer | The HTTP status code of the supplier's response. |
Bookings | 0 . . N | Array<BookDetails> | A list of detailed booking information retrieved during the operation. |
Bookings/Status | 1 | BookStatus | The current status of the booking. |
Bookings/Reference | 0 . . 1 | Reference | A collection of locators that identify the booking. |
Bookings/Reference/ ClientLocator | 0 . . 1 | String | The booking locator provided by the client.This is typically used to match the booking in the client's internal systems. |
Bookings/Reference/ SupplierLocator | 0 . . 1 | String | The booking locator provided by the supplier.This identifier is used to reference the booking in the supplier's system. |
Bookings/Reference/ HotelLocator | 0 . . 1 | String | The booking locator specific to the hotel, provided by the supplier. (Optional)This may be required in cases where the hotel system uses its own unique identifiers. |
Bookings/Holder | 0 . . 1 | Holder | The personal details of the booking holder. |
Bookings/Holder/Name | 1 | String | The name of the holder. |
Bookings/Holder/SurName | 1 | String | The surname of the holder. |
Bookings/Holder/ PersonalTitleType | 1 | PersonalTitleType | The personal title type of the holder. |
Bookings/Holder/ContactInfo | 0 . . 1 | ContactInfo | The contact information of the holder. |
Bookings/Holder/ContactInfo/ | 1 | String | The email address of the passenger. |
Bookings/Holder/ContactInfo/ Phone | 0 . . 1 | String | The phone number of the passenger. |
Bookings/Hotel | 0 . . 1 | HotelDetail | The hotel details associated with the booking. |
Bookings/Hotel/BookingDate | 0 . . 1 | String | The date when the booking was created. |
Bookings/Hotel/CheckIn | 0 . . 1 | String | The check-in date for the booking. |
Bookings/Hotel/CheckOut | 0 . . 1 | String | The check-out date for the booking. |
Bookings/Hotel/ CheckInAsDateTime | 0 . . 1 | String | The check-in date parsed as a DateTime object, expressed in UTC 0 |
Bookings/Hotel/ CheckOutAsDateTime | 0 . . 1 | String | The check-out date parsed as a DateTime object, expressed in UTC 0 |
Bookings/Hotel/HotelCode | 0 . . 1 | String | The unique code identifying the hotel. |
Bookings/Hotel/HotelName | 0 . . 1 | String | The name of the hotel associated with the booking. |
Bookings/Hotel/BoardCode | 0 . . 1 | String | The board code for the booking. |
Bookings/Hotel/Occupancies | 0 . . N | Array<BookOccupancy> | The collection of occupancies associated with the booking. |
Bookings/Hotel/Occupancies/ OccupancyId | 1 | Integer | The unique identifier for the occupancy. |
Bookings/Hotel/Occupancies/ Paxes | 1 . . N | Array<BookPaxInput> | The collection of passenger inputs (paxes) for the occupancy. |
Bookings/Hotel/Occupancies/ Paxes/Age | 1 | Integer | The age of the passenger. |
Bookings/Hotel/Occupancies/ Paxes/Name | 1 | String | The first name of the passenger. |
Bookings/Hotel/Occupancies/ Paxes/SurName | 1 | String | The surname (last name) of the passenger. |
Bookings/Hotel/Occupancies/ Paxes/PersonalTitleType | 1 | PersonalTitleType | The personal title type of the passenger. |
Bookings/Hotel/Rooms | 0 . . N | Array<Room> | The collection of rooms included in the booking. |
Bookings/Hotel/Rooms/ OccupancyRefId | 1 | Integer | Numeric ID linking this room to its occupancy data in the Occupancy. |
Bookings/Hotel/Rooms/Code | 1 | String | Unique code assigned to this room. |
Bookings/Hotel/Rooms/ Description | 0 . . 1 | String | Description of the room's features or characteristics. |
Bookings/Hotel/Rooms/RoomPrice | 1 | RoomPrice | Pricing information for the room, including total price and currency details. |
Bookings/Hotel/Rooms/RoomPrice/ Price | 1 | Price | The total price of the room. |
Bookings/Hotel/Rooms/RoomPrice/ Price/Currency | 1 | Currency | The currency of the price, represented in ISO 4217 format (e.g., USD, EUR). |
Bookings/Hotel/Rooms/RoomPrice/ Price/Binding | 1 | Boolean | Indicates whether the price is binding. |
Bookings/Hotel/Rooms/RoomPrice/ Price/Net | 1 | Double | The net price paid by the Buyer to the Seller. |
Bookings/Hotel/Rooms/RoomPrice/ Price/Gross | 1 | Double | The gross price, which includes the net price and the Buyer's commission. |
Bookings/Hotel/Rooms/RoomPrice/ Price/NetSpecified | 1 | Boolean | Indicates whether the net price is explicitly specified. |
Bookings/Hotel/Rooms/RoomPrice/ Price/MinimumSellingPrice | 1 | Double | The minimum selling price. |
Bookings/Hotel/Rooms/RoomPrice/ PriceBreakdown | 0 . . N | Array<PriceBreakdown> | Breakdown of the room price over specific periods, such as daily rates. |
Bookings/Hotel/Rooms/RoomPrice/ PriceBreakdown/Price | 1 | Price | The price for each day of the room during the specified period. |
Bookings/Hotel/Rooms/RoomPrice/ PriceBreakdown/Price/Currency | 1 | Currency | The currency of the price, represented in ISO 4217 format (e.g., USD, EUR). |
Bookings/Hotel/Rooms/RoomPrice/ PriceBreakdown/Price/Binding | 1 | Boolean | Indicates whether the price is binding. |
Bookings/Hotel/Rooms/RoomPrice/ PriceBreakdown/Price/Net | 1 | Double | The net price paid by the Buyer to the Seller. |
Bookings/Hotel/Rooms/RoomPrice/ PriceBreakdown/Price/Gross | 1 | Double | The gross price, which includes the net price and the Buyer's commission. |
Bookings/Hotel/Rooms/RoomPrice/ PriceBreakdown/Price/ NetSpecified | 1 | Boolean | Indicates whether the net price is explicitly specified. |
Bookings/Hotel/Rooms/RoomPrice/ PriceBreakdown/Price/ MinimumSellingPrice | 1 | Double | The minimum selling price. |
Bookings/Hotel/Rooms/RoomPrice/ PriceBreakdown/Start | 1 | Integer | The starting day of the pricing period (inclusive). |
Bookings/Hotel/Rooms/RoomPrice/ PriceBreakdown/End | 1 | Integer | The ending day of the pricing period (inclusive). |
Bookings/Hotel/Rooms/ Refundable | 1 | Boolean | Indicates if the room is refundable based on the cancellation policy. |
Bookings/Hotel/Rooms/ RefundableSpecified | 1 | Boolean | Indicates whether the refundable status has been explicitly specified. |
Bookings/Hotel/Rooms/ LegacyRoomId | 1 | String | Legacy identifier for internal tracking. Automatically generated using OccupancyRefId and Code. |
Bookings/Hotel/Rooms/Units | 0 . . 1 | Integer | Number of units available for this room type. |
Bookings/Hotel/Rooms/RatePlan | 0 . . 1 | RatePlan | Rate plan associated with this room. |
Bookings/Hotel/Rooms/RatePlan/ Code | 1 | String | The unique code for the rate plan. |
Bookings/Hotel/Rooms/RatePlan/ Name | 0 . . 1 | String | The name of the rate plan. |
Bookings/Hotel/Rooms/ Promotions | 0 . . N | Array<Promotion> | Promotions or discounts applicable to this room. |
Bookings/Hotel/Rooms/ Promotions/Code | 1 | String | The unique code identifying the promotion. |
Bookings/Hotel/Rooms/ Promotions/Name | 0 . . 1 | String | The name of the promotion. |
Bookings/Hotel/Rooms/Remarks | 0 . . N | Array<Remark> | Additional remarks or notes about this room. |
Bookings/Hotel/Rooms/Remarks/ RemarkType | 1 | RemarkType | The type of the remark, categorized by RemarkType, specifies its nature or purpose. It may refer to the hotel as a whole, a specific room being booked, services provided by the accommodation, or general remarks not tied to any particular entity. |
Bookings/Hotel/Rooms/Remarks/ Text | 1 | String | The text content of the remark, providing details or additional notes.This can include supplier-specific instructions, conditions, or general information. |
Bookings/Hotel/Rooms/ Surcharges | 0 . . N | Array<Surcharge> | Additional surcharges applied to this room. |
Bookings/Hotel/Rooms/ Surcharges/ChargeType | 1 | ChargeType | Specifies whether the surcharge is included in the room rate or must be paid separately at the property. See ChargeType for possible values. |
Bookings/Hotel/Rooms/ Surcharges/Mandatory | 1 | Boolean | Indicates whether this surcharge is mandatory. Mandatory surcharges, such as government taxes, must always be paid, while optional surcharges may depend on the guest's preferences. |
Bookings/Hotel/Rooms/ Surcharges/Description | 1 | String | Provides a description of the surcharge, giving context about the type of cost it represents.Examples: "Tourist Tax", "Resort Fee", or "Additional Bed Fee". |
Bookings/Hotel/Rooms/ Surcharges/Price | 1 | Price | Represents the price of this surcharge, including the amount and currency. See Price for details about the price structure. |
Bookings/Hotel/Rooms/ Surcharges/Price/Currency | 1 | Currency | The currency of the price, represented in ISO 4217 format (e.g., USD, EUR). |
Bookings/Hotel/Rooms/ Surcharges/Price/Binding | 1 | Boolean | Indicates whether the price is binding. |
Bookings/Hotel/Rooms/ Surcharges/Price/Net | 1 | Double | The net price paid by the Buyer to the Seller. |
Bookings/Hotel/Rooms/ Surcharges/Price/Gross | 1 | Double | The gross price, which includes the net price and the Buyer's commission. |
Bookings/Hotel/Rooms/ Surcharges/Price/NetSpecified | 1 | Boolean | Indicates whether the net price is explicitly specified. |
Bookings/Hotel/Rooms/ Surcharges/Price/ MinimumSellingPrice | 1 | Double | The minimum selling price. |
Bookings/Hotel/Rooms/ Surcharges/Code | 0 . . 1 | String | An optional code that uniquely identifies this surcharge for internal or external reference. This can be useful for tracking specific fees or integrating with supplier systems. |
Bookings/Hotel/Rooms/ CancelPolicy | 0 . . 1 | CancelPolicy | Cancellation policy specific to this room. |
Bookings/Hotel/Rooms/ CancelPolicy/Refundable | 1 | Boolean | Indicates whether the booking is refundable. |
Bookings/Hotel/Rooms/ CancelPolicy/CancelPenalties | 0 . . N | Array<CancelPenalty> | A collection of penalties that apply if the booking is canceled. |
Bookings/Hotel/Rooms/ CancelPolicy/CancelPenalties/ HoursBefore | 0 . . 1 | Integer | [Deprecated] This field is deprecated. Use Deadline instead. Indicates the number of hours before the check-in date when the penalty becomes applicable. |
Bookings/Hotel/Rooms/ CancelPolicy/CancelPenalties/ PenaltyType | 1 | PenaltyType | Specifies the type of penalty enforced upon cancellation. |
Bookings/Hotel/Rooms/ CancelPolicy/CancelPenalties/ Currency | 1 | Currency | Specifies the currency in which the penalty value is expressed. |
Bookings/Hotel/Rooms/ CancelPolicy/CancelPenalties/ Value | 1 | Double | Indicates the value of the penalty. |
Bookings/Hotel/Rooms/ CancelPolicy/CancelPenalties/ Deadline | 1 | String | Date on UTC Standard TimeZone in which this cancellation policy applies (ISO 8601 UTC 2025-11-01T05:00:00Z ) |
Bookings/Hotel/Rooms/ CancelPolicy/ CancelPolicyDescription | 0 . . 1 | String | Provides additional details or a textual summary of the cancellation policy. |
Bookings/Hotel/Rooms/Beds | 0 . . 1 | Array<Bed> | List of beds available in the room, including types and configurations. |
Bookings/Hotel/Rooms/Beds/Type | 0 . . 1 | String | The type of the bed. |
Bookings/Hotel/Rooms/Beds/ Description | 0 . . 1 | String | A description of the bed. |
Bookings/Hotel/Rooms/Beds/ Count | 0 . . 1 | Integer | The number of beds of this type in the room. |
Bookings/Hotel/Rooms/Beds/ Shared | 0 . . 1 | Boolean | Indicates whether the bed is shared. |
Bookings/Hotel/Rooms/Amenities | 0 . . N | Array<Amenity> | Amenities included with this room, such as Wi-Fi or parking. |
Bookings/Hotel/Rooms/Amenities/ Code | 1 | String | A unique code that identifies the amenity. |
Bookings/Hotel/Rooms/Amenities/ Type | 1 | AmenityType | The type of the amenity, defined by AmenityType. |
Bookings/Hotel/Rooms/Amenities/ Value | 1 | String | The value associated with the amenity. |
Bookings/Hotel/Rooms/Amenities/ Texts | 0 . . 1 | String | Additional textual information or description for the amenity. |
Bookings/Hotel/Rooms/ UnitsSpecified | 1 | Boolean | Indicates whether the number of units has been explicitly specified. |
Bookings/Hotel/Rooms/Features | 0 . . N | Array<Feature> | Features or custom attributes of the room, used for specific integrations. |
Bookings/Hotel/Rooms/Features/ Code | 1 | String | The unique code identifying the feature of the room. |
Bookings/Price | 0 . . 1 | Price | The total price of the booking. |
Bookings/Price/Currency | 1 | Currency | The currency of the price, represented in ISO 4217 format (e.g., USD, EUR). |
Bookings/Price/Binding | 1 | Boolean | Indicates whether the price is binding. |
Bookings/Price/Net | 1 | Double | The net price paid by the Buyer to the Seller. |
Bookings/Price/Gross | 1 | Double | The gross price, which includes the net price and the Buyer's commission. |
Bookings/Price/NetSpecified | 1 | Boolean | Indicates whether the net price is explicitly specified. |
Bookings/Price/ MinimumSellingPrice | 1 | Double | The minimum selling price. |
Bookings/CancelPolicy | 0 . . 1 | CancelPolicy | The cancellation policy associated with the booking. |
Bookings/CancelPolicy/ Refundable | 1 | Boolean | Indicates whether the booking is refundable. |
Bookings/CancelPolicy/ CancelPenalties | 0 . . N | Array<CancelPenalty> | A collection of penalties that apply if the booking is canceled. |
Bookings/CancelPolicy/ CancelPenalties/HoursBefore | 0 . . 1 | Integer | [Deprecated] This field is deprecated. Use Deadline instead. Indicates the number of hours before the check-in date when the penalty becomes applicable. |
Bookings/CancelPolicy/ CancelPenalties/PenaltyType | 1 | PenaltyType | Specifies the type of penalty enforced upon cancellation. |
Bookings/CancelPolicy/ CancelPenalties/Currency | 1 | Currency | Specifies the currency in which the penalty value is expressed. |
Bookings/CancelPolicy/ CancelPenalties/Value | 1 | Double | Indicates the value of the penalty. |
Bookings/CancelPolicy/ CancelPenalties/Deadline | 1 | String | Date on UTC Standard TimeZone in which this cancellation policy applies (ISO 8601 UTC 2025-11-01T05:00:00Z ) |
Bookings/CancelPolicy/ CancelPolicyDescription | 0 . . 1 | String | Provides additional details or a textual summary of the cancellation policy. |
Bookings/Remarks | 0 . . N | Array<Remark> | Additional remarks or notes related to the booking. |
Bookings/Remarks/RemarkType | 1 | RemarkType | The type of the remark, categorized by RemarkType, specifies its nature or purpose. It may refer to the hotel as a whole, a specific room being booked, services provided by the accommodation, or general remarks not tied to any particular entity. |
Bookings/Remarks/Text | 1 | String | The text content of the remark, providing details or additional notes.This can include supplier-specific instructions, conditions, or general information. |
Bookings/BillingSupplierCode | 0 . . 1 | String | The code of the agency responsible for the booking. |
Bookings/Payable | 0 . . 1 | String | Information about the entity responsible for payment of the booking. |
Bookings/AddOns | 0 . . 1 | Object | Additional metadata provided by the supplier for internal use. |
Parameters | 0 . . N | Array<Parameter> | A collection of parameters used to transfer data across different operations. |
Parameters/Key | 1 | Integer | Identifies the parameter with a numeric key. |
Parameters/Value | 1 | String | Defines the value associated with the parameter. |
Parameters/ParameterType | 1 | ParameterType | Specifies the type of the parameter (ParameterType), whether it is internal or supplier-related. |
Parameters/Immutable | 1 | Boolean | Indicates whether the parameter remains constant throughout operations (e.g., from Search to Quote and Book). In second searches or quotes, an immutable parameter is used to identify and match the same option. |
Parameters/RoomId | 1 | Integer | Associates the parameter with a specific room, identified by its ID. |
AddOns | 0 . . 1 | Object | Additional metadata provided by the supplier for internal use. |