Offer
Returns offers for one specific stay.
Calculates and returns available offers for a specific property, arrival and departure date.<br>You must have at least one of these scopes: 'offers.read, reservations.manage'.
get/booking/v1/offers
Query parameters
propertyIdstring required
The property ID
arrivalstring required
Date and optional time of arrival<br />Specify either a pure date or a date and time (without fractional second part) in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>
departurestring required
Date and optional time of departure. Cannot be more than 5 years after arrival.<br />Specify either a pure date or a date and time (without fractional second part) in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>
timeSliceTemplate'DayUse' | 'OverNight'
The time slice template used to filter the rate plans, defaults to 'over night'
timeSliceDefinitionIdsstring[]
Time slice definition IDs, used to filter rate plans
unitGroupIdsstring[]
Unit group IDs, used to filter rate plans
unitGroupTypesstring[]
Unit group types, used to filter rate plans
channelCode'Direct' | 'BookingCom' | 'Ibe' | 'ChannelManager' | 'Expedia' | 'Homelike' | 'Hrs' | 'AltoVita' | 'DesVu' | 'Gimsi'
Channel code, used to filter the rate plans
promoCodestring
The promo code associated with a certain special offer
corporateCodestring
The code associated with a corporate rate
adultsinteger required
The number of adults you want offers for
childrenAgesinteger[]
The ages of the children you want offers for
includeUnavailableboolean
Return also offers that are currently not publicly bookable as restrictions are violated. By default only available offers are returned
Response
Success.
Example response
{
"property": {
"id": "MUC",
"code": "MUC",
"name": "Demo Hotel Munich",
"description": "This is the demo hotel Munich"
},
"offers": [
{
"arrival": "2026-09-03T17:00:00+02:00",
"departure": "2026-09-05T11:00:00+02:00",
"unitGroup": {
"id": "MUC-SGL",
"code": "SGL",
"name": "Standard",
"description": "Standard",
"maxPersons": 1,
"rank": 2,
"type": "BedRoom"
},
"minGuaranteeType": "PM6Hold",
"availableUnits": 4,
"ratePlan": {
"id": "MUC-NONREF_SGL",
"code": "NONREF",
"name": "Non Refundable",
"description": "Non Refundable",
"isSubjectToCityTax": false
},
"totalGrossAmount": {
"amount": 279,
"currency": "EUR"
},
"cancellationFee": {
"code": "FLEX",
"name": "Flexible",
"description": "Free cancellation.",
"dueDateTime": "2026-09-03T17:00:00+02:00",
"fee": {
"amount": 279,
"currency": "EUR"
}
},
"noShowFee": {
"code": "NOSHOW",
"name": "Non Refundable",
"description": "No free no-show",
"fee": {
"amount": 279,
"currency": "EUR"
}
},
"timeSlices": [
{
"from": "2026-09-03T17:00:00+02:00",
"to": "2026-09-04T11:00:00+02:00",
"availableUnits": 4,
"baseAmount": {
"grossAmount": 107,
"netAmount": 100,
"vatType": "Reduced",
"vatPercent": 7,
"currency": "EUR"
},
"totalGrossAmount": {
"amount": 117,
"currency": "EUR"
},
"includedServices": [
{
"service": {
"id": "MUC-WLAN"
},
"serviceDate": "2026-09-03",
"count": 1,
"availableCount": 5,
"amount": {
"grossAmount": 10,
"netAmount": 8.4,
"vatType": "Normal",
"vatPercent": 19,
"currency": "EUR"
},
"pricingMode": "Included"
}
]
},
{
"from": "2026-09-04T11:00:00+02:00",
"to": "2026-09-05T11:00:00+02:00",
"availableUnits": 5,
"baseAmount": {
"grossAmount": 107,
"netAmount": 100,
"vatType": "Reduced",
"vatPercent": 7,
"currency": "EUR"
},
"totalGrossAmount": {
"amount": 142,
"currency": "EUR"
},
"includedServices": [
{
"service": {
"id": "MUC-WLAN"
},
"serviceDate": "2026-09-04",
"count": 1,
"availableCount": 5,
"amount": {
"grossAmount": 10,
"netAmount": 8.4,
"vatType": "Normal",
"vatPercent": 19,
"currency": "EUR"
},
"pricingMode": "Included"
},
{
"service": {
"id": "MUC-CLEANING"
},
"serviceDate": "2026-09-04",
"count": 1,
"availableCount": 2,
"amount": {
"grossAmount": 25,
"netAmount": 21.01,
"vatType": "Normal",
"vatPercent": 19,
"currency": "EUR"
},
"pricingMode": "Additional"
}
]
}
],
"services": [
{
"service": {
"id": "MUC-PARKING",
"code": "PARKING",
"name": "Parking",
"description": "Parking spot per night",
"pricingUnit": "Room",
"defaultGrossPrice": {
"amount": 20,
"currency": "EUR"
}
},
"count": 1,
"availableCount": 3,
"totalAmount": {
"grossAmount": 20,
"netAmount": 16.81,
"vatType": "Normal",
"vatPercent": 19,
"currency": "EUR"
},
"prePaymentAmount": {
"amount": 0,
"currency": "EUR"
},
"dates": [
{
"serviceDate": "2026-09-03",
"amount": {
"grossAmount": 20,
"netAmount": 16.81,
"vatType": "Normal",
"vatPercent": 19,
"currency": "EUR"
},
"isDefaultDate": true,
"isMandatory": false,
"availableCount": 3
}
]
}
],
"taxDetails": [
{
"vatType": "Reduced",
"vatPercent": 7,
"net": {
"amount": 200,
"currency": "EUR"
},
"tax": {
"amount": 14,
"currency": "EUR"
}
},
{
"vatType": "Normal",
"vatPercent": 19,
"net": {
"amount": 54.62,
"currency": "EUR"
},
"tax": {
"amount": 10.38,
"currency": "EUR"
}
}
],
"isCorporate": false,
"prePaymentAmount": {
"amount": 0,
"currency": "EUR"
},
"cityTaxes": [
{
"id": "MUC-TAX",
"code": "TAX",
"name": "City tax",
"totalGrossAmount": {
"amount": 119,
"currency": "EUR"
},
"dates": [
{
"serviceDate": "2021-08-27",
"amount": {
"grossAmount": 119,
"netAmount": 100,
"vatType": "Normal",
"vatPercent": 19,
"currency": "EUR"
}
}
]
}
]
},
{
"arrival": "2026-09-03T17:00:00+02:00",
"departure": "2026-09-05T11:00:00+02:00",
"unitGroup": {
"id": "MUC-SGL",
"code": "SGL",
"name": "Standard",
"description": "Standard",
"maxPersons": 1,
"rank": 2,
"type": "BedRoom"
},
"minGuaranteeType": "Prepayment",
"availableUnits": 4,
"ratePlan": {
"id": "MUC-FLEX_SGL",
"code": "FLEX",
"name": "Flexible",
"description": "Flexible",
"isSubjectToCityTax": false
},
"totalGrossAmount": {
"amount": 503,
"currency": "EUR"
},
"cancellationFee": {
"code": "NONREF",
"name": "Non Refundable",
"description": "Full stay amount due 24 hours after booking.",
"dueDateTime": "2026-09-02T13:40:59.7493356+02:00",
"fee": {
"amount": 503,
"currency": "EUR"
}
},
"noShowFee": {
"code": "NOSHOW",
"name": "Non Refundable",
"description": "No free no-show",
"fee": {
"amount": 503,
"currency": "EUR"
}
},
"timeSlices": [
{
"from": "2026-09-03T17:00:00+02:00",
"to": "2026-09-04T11:00:00+02:00",
"availableUnits": 4,
"baseAmount": {
"grossAmount": 214,
"netAmount": 200,
"vatType": "Reduced",
"vatPercent": 7,
"currency": "EUR"
},
"totalGrossAmount": {
"amount": 224,
"currency": "EUR"
},
"includedServices": [
{
"service": {
"id": "MUC-WLAN"
},
"serviceDate": "2026-09-03",
"count": 1,
"availableCount": 5,
"amount": {
"grossAmount": 10,
"netAmount": 8.4,
"vatType": "Normal",
"vatPercent": 19,
"currency": "EUR"
},
"pricingMode": "Included"
}
]
},
{
"from": "2026-09-04T11:00:00+02:00",
"to": "2026-09-05T11:00:00+02:00",
"availableUnits": 5,
"baseAmount": {
"grossAmount": 214,
"netAmount": 200,
"vatType": "Reduced",
"vatPercent": 7,
"currency": "EUR"
},
"totalGrossAmount": {
"amount": 249,
"currency": "EUR"
},
"includedServices": [
{
"service": {
"id": "MUC-WLAN"
},
"serviceDate": "2026-09-04",
"count": 1,
"availableCount": 5,
"amount": {
"grossAmount": 10,
"netAmount": 8.4,
"vatType": "Normal",
"vatPercent": 19,
"currency": "EUR"
},
"pricingMode": "Included"
},
{
"service": {
"id": "MUC-CLEANING"
},
"serviceDate": "2026-09-04",
"count": 1,
"availableCount": 2,
"amount": {
"grossAmount": 25,
"netAmount": 21.01,
"vatType": "Normal",
"vatPercent": 19,
"currency": "EUR"
},
"pricingMode": "Additional"
}
]
}
],
"services": [
{
"service": {
"id": "MUC-SPA",
"code": "SPA",
"name": "Spa access",
"description": "Spa access per stay",
"pricingUnit": "Person",
"defaultGrossPrice": {
"amount": 30,
"currency": "EUR"
}
},
"count": 1,
"availableCount": 2,
"totalAmount": {
"grossAmount": 30,
"netAmount": 25.21,
"vatType": "Normal",
"vatPercent": 19,
"currency": "EUR"
},
"prePaymentAmount": {
"amount": 0,
"currency": "EUR"
},
"dates": [
{
"serviceDate": "2026-09-03",
"amount": {
"grossAmount": 30,
"netAmount": 25.21,
"vatType": "Normal",
"vatPercent": 19,
"currency": "EUR"
},
"isDefaultDate": true,
"isMandatory": false,
"availableCount": 2
}
]
}
],
"taxDetails": [
{
"vatType": "Reduced",
"vatPercent": 7,
"net": {
"amount": 400,
"currency": "EUR"
},
"tax": {
"amount": 28,
"currency": "EUR"
}
},
{
"vatType": "Normal",
"vatPercent": 19,
"net": {
"amount": 63.02,
"currency": "EUR"
},
"tax": {
"amount": 11.98,
"currency": "EUR"
}
}
],
"isCorporate": false,
"prePaymentAmount": {
"amount": 503,
"currency": "EUR"
}
}
]
}Changes
No recorded changes to this endpoint across all 1 revision of this API.