Reservation
Returns offers for one specific reservation.
Calculates and returns offers for amending a specific reservation.<br>You must have at least one of these scopes: 'offers.read, reservations.manage'.
get/booking/v1/reservations/{id}/offers
Path parameters
idstring required
Id of the reservation to be amended.
Query parameters
arrivalstring
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
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>
adultsinteger
Number of adults
childrenAgesinteger[]
Ages of children
channelCode'Direct' | 'BookingCom' | 'Ibe' | 'ChannelManager' | 'Expedia' | 'Homelike' | 'Hrs' | 'AltoVita' | 'DesVu' | 'Gimsi'
The channel code used to filter the rate plans
promoCodestring
The promo code associated with a certain special offer, like corporate rate
corporateCodestring
The code associated with a corporate rate
requoteboolean
Whether the offers should be re-quoted based on current prices, or only additions like change of number of adults should be calculated. Defaults to 'false'
includeUnavailableboolean
Return also offers that are currently not publicly bookable as restrictions are violated. By default only available offers are returned
unitGroupIdsstring[]
The list of unit groups used to filter the offers.
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",
"minGuaranteeType": "PM6Hold",
"availableUnits": 4,
"totalGrossAmount": {
"amount": 214,
"currency": "EUR"
},
"cancellationFee": {
"code": "FLEX",
"name": "Flexible",
"description": "Free cancellation.",
"dueDateTime": "2026-09-03T17:00:00+02:00",
"fee": {
"amount": 214,
"currency": "EUR"
}
},
"noShowFee": {
"code": "NOSHOW",
"name": "Non Refundable",
"description": "No free no-show",
"fee": {
"amount": 214,
"currency": "EUR"
}
},
"timeSlices": [
{
"from": "2026-09-03T17:00:00+02:00",
"to": "2026-09-04T11:00:00+02:00",
"ratePlan": {
"id": "MUC-FLEX_DBL",
"code": "FLEX",
"name": "Flexible",
"description": "Flexible",
"isSubjectToCityTax": false
},
"unitGroup": {
"id": "MUC-DBL",
"code": "DBL",
"name": "Double",
"description": "Double",
"maxPersons": 2,
"rank": 1,
"type": "BedRoom"
},
"baseAmount": {
"grossAmount": 40,
"netAmount": 37.38,
"vatType": "Reduced",
"vatPercent": 7,
"currency": "EUR"
},
"totalGrossAmount": {
"amount": 50,
"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"
},
"bookedAsExtra": false,
"pricingMode": "Included"
}
]
},
{
"from": "2026-09-04T11:00:00+02:00",
"to": "2026-09-05T11:00:00+02:00",
"ratePlan": {
"id": "MUC-NONREF_SGL",
"code": "NONREF",
"name": "Non Refundable",
"description": "Non Refundable",
"isSubjectToCityTax": false
},
"unitGroup": {
"id": "MUC-SGL",
"code": "SGL",
"name": "Standard",
"description": "Standard",
"maxPersons": 1,
"rank": 2,
"type": "BedRoom"
},
"baseAmount": {
"grossAmount": 59,
"netAmount": 55.14,
"vatType": "Reduced",
"vatPercent": 7,
"currency": "EUR"
},
"totalGrossAmount": {
"amount": 69,
"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"
},
"bookedAsExtra": false,
"pricingMode": "Included"
},
{
"service": {
"id": "MUC-CLEANING"
},
"serviceDate": "2026-09-03",
"count": 1,
"availableCount": 2,
"amount": {
"grossAmount": 25,
"netAmount": 21,
"vatType": "Normal",
"vatPercent": 19,
"currency": "EUR"
},
"bookedAsExtra": false,
"pricingMode": "Additional"
}
]
}
],
"services": [
{
"service": {
"id": "MUC-BRKF",
"code": "BRKF",
"name": "Breakfast",
"description": "Best breakfast on this side of the Weißwurstäquator.",
"pricingUnit": "Person",
"defaultGrossPrice": {
"amount": 10,
"currency": "EUR"
}
},
"count": 1,
"totalAmount": {
"grossAmount": 11.9,
"netAmount": 10,
"vatType": "Normal",
"vatPercent": 19,
"currency": "EUR"
},
"prePaymentAmount": {
"amount": 27,
"currency": "EUR"
},
"dates": [
{
"serviceDate": "2026-09-04",
"amount": {
"grossAmount": 11.9,
"netAmount": 10,
"vatType": "Normal",
"vatPercent": 19,
"currency": "EUR"
},
"isDefaultDate": false,
"isMandatory": false
}
]
}
],
"taxDetails": [
{
"vatType": "Normal",
"vatPercent": 14,
"net": {
"amount": 200,
"currency": "EUR"
},
"tax": {
"amount": 14,
"currency": "EUR"
}
}
],
"isCorporate": false,
"cityTaxes": [
{
"id": "MUC",
"code": "MUC",
"name": "Munich City Tax",
"totalGrossAmount": {
"amount": 11.9,
"currency": "EUR"
},
"dates": [
{
"serviceDate": "2026-09-04",
"amount": {
"grossAmount": 11.9,
"netAmount": 10,
"vatType": "Normal",
"vatPercent": 19,
"currency": "EUR"
}
}
]
}
]
},
{
"arrival": "2026-09-03T17:00:00+02:00",
"departure": "2026-09-05T11:00:00+02:00",
"minGuaranteeType": "PM6Hold",
"availableUnits": 8,
"totalGrossAmount": {
"amount": 214,
"currency": "EUR"
},
"cancellationFee": {
"code": "FLEX",
"name": "Flexible",
"description": "Free cancellation.",
"dueDateTime": "2026-09-03T17:00:00+02:00",
"fee": {
"amount": 214,
"currency": "EUR"
}
},
"noShowFee": {
"code": "NOSHOW",
"name": "Non Refundable",
"description": "No free no-show",
"fee": {
"amount": 214,
"currency": "EUR"
}
},
"timeSlices": [
{
"from": "2026-09-03T17:00:00+02:00",
"to": "2026-09-04T11:00:00+02:00",
"ratePlan": {
"id": "MUC-FLEX_DBL",
"code": "FLEX",
"name": "Flexible",
"description": "Flexible",
"isSubjectToCityTax": false
},
"unitGroup": {
"id": "MUC-DBL",
"code": "DBL",
"name": "Double",
"description": "Double",
"maxPersons": 2,
"rank": 1,
"type": "BedRoom"
},
"baseAmount": {
"grossAmount": 90,
"netAmount": 84.11,
"vatType": "Reduced",
"vatPercent": 7,
"currency": "EUR"
},
"totalGrossAmount": {
"amount": 100,
"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"
},
"bookedAsExtra": false,
"pricingMode": "Included"
}
]
},
{
"from": "2026-09-04T11:00:00+02:00",
"to": "2026-09-05T11:00:00+02:00",
"ratePlan": {
"id": "MUC-NONREF_SGL",
"code": "NONREF",
"name": "Non Refundable",
"description": "Non Refundable",
"isSubjectToCityTax": false
},
"unitGroup": {
"id": "MUC-SGL",
"code": "SGL",
"name": "Standard",
"description": "Standard",
"maxPersons": 1,
"rank": 2,
"type": "BedRoom"
},
"baseAmount": {
"grossAmount": 124,
"netAmount": 115.89,
"vatType": "Reduced",
"vatPercent": 7,
"currency": "EUR"
},
"totalGrossAmount": {
"amount": 134,
"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"
},
"bookedAsExtra": false,
"pricingMode": "Included"
},
{
"service": {
"id": "MUC-CLEANING"
},
"serviceDate": "2026-09-03",
"count": 1,
"availableCount": 2,
"amount": {
"grossAmount": 25,
"netAmount": 21,
"vatType": "Normal",
"vatPercent": 19,
"currency": "EUR"
},
"bookedAsExtra": false,
"pricingMode": "Additional"
}
]
}
],
"taxDetails": [
{
"vatType": "Reduced",
"vatPercent": 14,
"net": {
"amount": 100,
"currency": "EUR"
},
"tax": {
"amount": 14,
"currency": "EUR"
}
}
],
"isCorporate": false
}
]
}Changes
No recorded changes to this endpoint across all 1 revision of this API.