Link

Upgrade rooms

When you want to upgrade a reservation, you have to retrieve all alternative offers for this one reservation and find the offer that matches best. Find the one with the same cancellation policies and guarantees, or anything else that makes sense to you. This is your expertise, not ours. You can override the prices for each night based on any upselling rules defined in your app. When getting the offers, be sure not to change any of the core parameters, but set the requote flag to true. As you do not want to offer lower value rooms, you can use the rank of the unit groups in apaleo, if the hotel sets them up. You can also use the prices of the offers or use any hierarchy or upselling models in your application.

GET /booking/v1/reservations/{id}/offers

Example

{
    "property":{
        "id":"LND",
        "code":"LND",
        "name":"Hotel London",
        "description":"Located in a quiet side street with a beautiful garden in the backyard, Hotel London is prefect for relaxing after a day of shopping or a night of partying."
    },
    "offers":[
        {
            "arrival":"2020-09-24T16:00:00+01:00",
            "departure":"2020-09-27T10:00:00+01:00",
            "minGuaranteeType":"Prepayment",
            "availableUnits":1,
            "totalGrossAmount":{
                "amount":356,
                "currency":"GBP"
            },
            "cancellationFee":{
                "code":"STR",
                "name":"Strict",
                "description":"No free cancellation.",
                "dueDateTime":"2020-09-23T08:24:53.092124+01:00",
                "fee":{
                    "amount":266,
                    "currency":"GBP"
                }
            },
            "noShowFee":{
                "code":"NONREF",
                "fee":{
                    "amount":266,
                    "currency":"GBP"
                }
            },
            "timeSlices":[
                {
                    "from":"2020-09-24T16:00:00+01:00",
                    "to":"2020-09-25T09:00:00+01:00",
                    "ratePlan":{
                        "id":"LND-NONREF-SGL",
                        "code":"NONREF",
                        "name":"Non Refundable",
                        "description":"Pay in advance and safe. If you cancel we well keep the amount of the full stay.",
                        "isSubjectToCityTax":true
                    },
                    "unitGroup":{
                        "id":"LND-SGL",
                        "code":"SGL",
                        "name":"Single",
                        "description":"Nice and comfortable room with shower and single bed.",
                        "maxPersons":1
                    },
                    "baseAmount":{
                        "grossAmount":94,
                        "netAmount":89.52,
                        "vatType":"Reduced",
                        "currency":"GBP"
                    },
                    "totalGrossAmount":{
                        "amount":94,
                        "currency":"GBP"
                    }
                },
                {
                    "from":"2020-09-25T09:00:00+01:00",
                    "to":"2020-09-26T09:00:00+01:00",
                    "ratePlan":{
                        "id":"LND-NONREF-SGL",
                        "code":"NONREF",
                        "name":"Non Refundable",
                        "description":"Pay in advance and safe. If you cancel we well keep the amount of the full stay.",
                        "isSubjectToCityTax":true
                    },
                    "unitGroup":{
                        "id":"LND-SGL",
                        "code":"SGL",
                        "name":"Single",
                        "description":"Nice and comfortable room with shower and single bed.",
                        "maxPersons":1
                    },
                    "baseAmount":{
                        "grossAmount":81,
                        "netAmount":77.14,
                        "vatType":"Reduced",
                        "currency":"GBP"
                    },
                    "totalGrossAmount":{
                        "amount":81,
                        "currency":"GBP"
                    }
                },
                {
                    "from":"2020-09-26T09:00:00+01:00",
                    "to":"2020-09-27T10:00:00+01:00",
                    "ratePlan":{
                        "id":"LND-NONREF-SGL",
                        "code":"NONREF",
                        "name":"Non Refundable",
                        "description":"Pay in advance and safe. If you cancel we well keep the amount of the full stay.",
                        "isSubjectToCityTax":true
                    },
                    "unitGroup":{
                        "id":"LND-SGL",
                        "code":"SGL",
                        "name":"Single",
                        "description":"Nice and comfortable room with shower and single bed.",
                        "maxPersons":1
                    },
                    "baseAmount":{
                        "grossAmount":91,
                        "netAmount":86.67,
                        "vatType":"Reduced",
                        "currency":"GBP"
                    },
                    "totalGrossAmount":{
                        "amount":91,
                        "currency":"GBP"
                    }
                }
            ],
            "services":[
                {
                    "service":{
                        "id":"LND-BRKF",
                        "code":"BRKF",
                        "name":"Breakfast",
                        "description":"Enjoy fresh fruit, just-baked viennoiseries, or a hearty morning meal.",
                        "pricingUnit":"Person",
                        "defaultGrossPrice":{
                            "amount":20,
                            "currency":"GBP"
                        }
                    },
                    "count":1,
                    "totalAmount":{
                        "grossAmount":60,
                        "netAmount":50.01,
                        "vatType":"Normal",
                        "currency":"GBP"
                    },
                    "prePaymentAmount":{
                        "amount":60,
                        "currency":"GBP"
                    },
                    "dates":[
                        {
                            "serviceDate":"2020-09-25",
                            "amount":{
                                "grossAmount":20,
                                "netAmount":16.67,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        },
                        {
                            "serviceDate":"2020-09-26",
                            "amount":{
                                "grossAmount":20,
                                "netAmount":16.67,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        },
                        {
                            "serviceDate":"2020-09-27",
                            "amount":{
                                "grossAmount":20,
                                "netAmount":16.67,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        }
                    ]
                },
                {
                    "service":{
                        "id":"LND-WLAN",
                        "code":"WLAN",
                        "name":"High-Speed WLAN",
                        "description":"Upgrade the complimentary internet access to a high speed connection.",
                        "pricingUnit":"Room",
                        "defaultGrossPrice":{
                            "amount":10,
                            "currency":"GBP"
                        }
                    },
                    "count":1,
                    "totalAmount":{
                        "grossAmount":30,
                        "netAmount":24.99,
                        "vatType":"Normal",
                        "currency":"GBP"
                    },
                    "prePaymentAmount":{
                        "amount":30,
                        "currency":"GBP"
                    },
                    "dates":[
                        {
                            "serviceDate":"2020-09-24",
                            "amount":{
                                "grossAmount":10,
                                "netAmount":8.33,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        },
                        {
                            "serviceDate":"2020-09-25",
                            "amount":{
                                "grossAmount":10,
                                "netAmount":8.33,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        },
                        {
                            "serviceDate":"2020-09-26",
                            "amount":{
                                "grossAmount":10,
                                "netAmount":8.33,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        }
                    ]
                }
            ],
            "taxDetails":[
                {
                    "vatType":"Null",
                    "vatPercent":0,
                    "net":{
                        "amount":0,
                        "currency":"GBP"
                    },
                    "tax":{
                        "amount":0,
                        "currency":"GBP"
                    }
                },
                {
                    "vatType":"Reduced",
                    "vatPercent":5,
                    "net":{
                        "amount":253.33,
                        "currency":"GBP"
                    },
                    "tax":{
                        "amount":12.67,
                        "currency":"GBP"
                    }
                },
                {
                    "vatType":"Normal",
                    "vatPercent":20,
                    "net":{
                        "amount":75,
                        "currency":"GBP"
                    },
                    "tax":{
                        "amount":15,
                        "currency":"GBP"
                    }
                },
                {
                    "vatType":"Without",
                    "vatPercent":0,
                    "net":{
                        "amount":0,
                        "currency":"GBP"
                    },
                    "tax":{
                        "amount":0,
                        "currency":"GBP"
                    }
                }
            ],
            "isCorporate":false
        },
        {
            "arrival":"2020-09-24T16:00:00+01:00",
            "departure":"2020-09-27T10:00:00+01:00",
            "minGuaranteeType":"CreditCard",
            "availableUnits":27,
            "totalGrossAmount":{
                "amount":536,
                "currency":"GBP"
            },
            "cancellationFee":{
                "code":"STR",
                "name":"Strict",
                "description":"No free cancellation.",
                "dueDateTime":"2020-09-23T08:24:53.092124+01:00",
                "fee":{
                    "amount":401.03,
                    "currency":"GBP"
                }
            },
            "noShowFee":{
                "code":"NONREF",
                "fee":{
                    "amount":401.03,
                    "currency":"GBP"
                }
            },
            "timeSlices":[
                {
                    "from":"2020-09-24T16:00:00+01:00",
                    "to":"2020-09-25T09:00:00+01:00",
                    "ratePlan":{
                        "id":"LND-IBRKF-DBL",
                        "code":"IBRKF",
                        "name":"Include breakfast",
                        "description":"A rate for double rooms with breakfast included.",
                        "isSubjectToCityTax":true
                    },
                    "unitGroup":{
                        "id":"LND-DBL",
                        "code":"DBL",
                        "name":"Double",
                        "description":"Big room with balcony, whirlpool and a kingsize bed.",
                        "maxPersons":2
                    },
                    "baseAmount":{
                        "grossAmount":139.01,
                        "netAmount":132.39,
                        "vatType":"Reduced",
                        "currency":"GBP"
                    },
                    "totalGrossAmount":{
                        "amount":154,
                        "currency":"GBP"
                    },
                    "includedServices":[
                        {
                            "service":{
                                "id":"LND-BRKF",
                                "code":"BRKF",
                                "name":"Breakfast",
                                "description":"Enjoy fresh fruit, just-baked viennoiseries, or a hearty morning meal."
                            },
                            "serviceDate":"2020-09-25",
                            "count":1,
                            "amount":{
                                "grossAmount":14.99,
                                "netAmount":12.49,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "bookedAsExtra":true,
                            "pricingMode":"Included"
                        }
                    ]
                },
                {
                    "from":"2020-09-25T09:00:00+01:00",
                    "to":"2020-09-26T09:00:00+01:00",
                    "ratePlan":{
                        "id":"LND-IBRKF-DBL",
                        "code":"IBRKF",
                        "name":"Include breakfast",
                        "description":"A rate for double rooms with breakfast included.",
                        "isSubjectToCityTax":true
                    },
                    "unitGroup":{
                        "id":"LND-DBL",
                        "code":"DBL",
                        "name":"Double",
                        "description":"Big room with balcony, whirlpool and a kingsize bed.",
                        "maxPersons":2
                    },
                    "baseAmount":{
                        "grossAmount":126.01,
                        "netAmount":120.01,
                        "vatType":"Reduced",
                        "currency":"GBP"
                    },
                    "totalGrossAmount":{
                        "amount":141,
                        "currency":"GBP"
                    },
                    "includedServices":[
                        {
                            "service":{
                                "id":"LND-BRKF",
                                "code":"BRKF",
                                "name":"Breakfast",
                                "description":"Enjoy fresh fruit, just-baked viennoiseries, or a hearty morning meal."
                            },
                            "serviceDate":"2020-09-26",
                            "count":1,
                            "amount":{
                                "grossAmount":14.99,
                                "netAmount":12.49,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "bookedAsExtra":true,
                            "pricingMode":"Included"
                        }
                    ]
                },
                {
                    "from":"2020-09-26T09:00:00+01:00",
                    "to":"2020-09-27T10:00:00+01:00",
                    "ratePlan":{
                        "id":"LND-IBRKF-DBL",
                        "code":"IBRKF",
                        "name":"Include breakfast",
                        "description":"A rate for double rooms with breakfast included.",
                        "isSubjectToCityTax":true
                    },
                    "unitGroup":{
                        "id":"LND-DBL",
                        "code":"DBL",
                        "name":"Double",
                        "description":"Big room with balcony, whirlpool and a kingsize bed.",
                        "maxPersons":2
                    },
                    "baseAmount":{
                        "grossAmount":136.01,
                        "netAmount":129.53,
                        "vatType":"Reduced",
                        "currency":"GBP"
                    },
                    "totalGrossAmount":{
                        "amount":151,
                        "currency":"GBP"
                    },
                    "includedServices":[
                        {
                            "service":{
                                "id":"LND-BRKF",
                                "code":"BRKF",
                                "name":"Breakfast",
                                "description":"Enjoy fresh fruit, just-baked viennoiseries, or a hearty morning meal."
                            },
                            "serviceDate":"2020-09-27",
                            "count":1,
                            "amount":{
                                "grossAmount":14.99,
                                "netAmount":12.49,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "bookedAsExtra":true,
                            "pricingMode":"Included"
                        }
                    ]
                }
            ],
            "services":[
                {
                    "service":{
                        "id":"LND-BRKF",
                        "code":"BRKF",
                        "name":"Breakfast",
                        "description":"Enjoy fresh fruit, just-baked viennoiseries, or a hearty morning meal.",
                        "pricingUnit":"Person",
                        "defaultGrossPrice":{
                            "amount":20,
                            "currency":"GBP"
                        }
                    },
                    "count":1,
                    "totalAmount":{
                        "grossAmount":60,
                        "netAmount":50.01,
                        "vatType":"Normal",
                        "currency":"GBP"
                    },
                    "prePaymentAmount":{
                        "amount":0,
                        "currency":"GBP"
                    },
                    "dates":[
                        {
                            "serviceDate":"2020-09-25",
                            "amount":{
                                "grossAmount":20,
                                "netAmount":16.67,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        },
                        {
                            "serviceDate":"2020-09-26",
                            "amount":{
                                "grossAmount":20,
                                "netAmount":16.67,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        },
                        {
                            "serviceDate":"2020-09-27",
                            "amount":{
                                "grossAmount":20,
                                "netAmount":16.67,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        }
                    ]
                },
                {
                    "service":{
                        "id":"LND-WLAN",
                        "code":"WLAN",
                        "name":"High-Speed WLAN",
                        "description":"Upgrade the complimentary internet access to a high speed connection.",
                        "pricingUnit":"Room",
                        "defaultGrossPrice":{
                            "amount":10,
                            "currency":"GBP"
                        }
                    },
                    "count":1,
                    "totalAmount":{
                        "grossAmount":30,
                        "netAmount":24.99,
                        "vatType":"Normal",
                        "currency":"GBP"
                    },
                    "prePaymentAmount":{
                        "amount":0,
                        "currency":"GBP"
                    },
                    "dates":[
                        {
                            "serviceDate":"2020-09-24",
                            "amount":{
                                "grossAmount":10,
                                "netAmount":8.33,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        },
                        {
                            "serviceDate":"2020-09-25",
                            "amount":{
                                "grossAmount":10,
                                "netAmount":8.33,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        },
                        {
                            "serviceDate":"2020-09-26",
                            "amount":{
                                "grossAmount":10,
                                "netAmount":8.33,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        }
                    ]
                }
            ],
            "taxDetails":[
                {
                    "vatType":"Null",
                    "vatPercent":0,
                    "net":{
                        "amount":0,
                        "currency":"GBP"
                    },
                    "tax":{
                        "amount":0,
                        "currency":"GBP"
                    }
                },
                {
                    "vatType":"Reduced",
                    "vatPercent":5,
                    "net":{
                        "amount":381.93,
                        "currency":"GBP"
                    },
                    "tax":{
                        "amount":19.1,
                        "currency":"GBP"
                    }
                },
                {
                    "vatType":"Normal",
                    "vatPercent":20,
                    "net":{
                        "amount":112.48,
                        "currency":"GBP"
                    },
                    "tax":{
                        "amount":22.5,
                        "currency":"GBP"
                    }
                },
                {
                    "vatType":"Without",
                    "vatPercent":0,
                    "net":{
                        "amount":0,
                        "currency":"GBP"
                    },
                    "tax":{
                        "amount":0,
                        "currency":"GBP"
                    }
                }
            ],
            "isCorporate":false
        },
        {
            "arrival":"2020-09-24T16:00:00+01:00",
            "departure":"2020-09-27T10:00:00+01:00",
            "minGuaranteeType":"Prepayment",
            "availableUnits":27,
            "totalGrossAmount":{
                "amount":446,
                "currency":"GBP"
            },
            "cancellationFee":{
                "code":"STR",
                "name":"Strict",
                "description":"No free cancellation.",
                "dueDateTime":"2020-09-23T08:24:53.092124+01:00",
                "fee":{
                    "amount":356,
                    "currency":"GBP"
                }
            },
            "noShowFee":{
                "code":"NONREF",
                "fee":{
                    "amount":356,
                    "currency":"GBP"
                }
            },
            "timeSlices":[
                {
                    "from":"2020-09-24T16:00:00+01:00",
                    "to":"2020-09-25T09:00:00+01:00",
                    "ratePlan":{
                        "id":"LND-NONREF-DBL",
                        "code":"NONREF",
                        "name":"Non Refundable",
                        "description":"Pay in advance and safe. If you cancel we well keep the amount of the full stay.",
                        "isSubjectToCityTax":true
                    },
                    "unitGroup":{
                        "id":"LND-DBL",
                        "code":"DBL",
                        "name":"Double",
                        "description":"Big room with balcony, whirlpool and a kingsize bed.",
                        "maxPersons":2
                    },
                    "baseAmount":{
                        "grossAmount":124,
                        "netAmount":118.1,
                        "vatType":"Reduced",
                        "currency":"GBP"
                    },
                    "totalGrossAmount":{
                        "amount":124,
                        "currency":"GBP"
                    }
                },
                {
                    "from":"2020-09-25T09:00:00+01:00",
                    "to":"2020-09-26T09:00:00+01:00",
                    "ratePlan":{
                        "id":"LND-NONREF-DBL",
                        "code":"NONREF",
                        "name":"Non Refundable",
                        "description":"Pay in advance and safe. If you cancel we well keep the amount of the full stay.",
                        "isSubjectToCityTax":true
                    },
                    "unitGroup":{
                        "id":"LND-DBL",
                        "code":"DBL",
                        "name":"Double",
                        "description":"Big room with balcony, whirlpool and a kingsize bed.",
                        "maxPersons":2
                    },
                    "baseAmount":{
                        "grossAmount":111,
                        "netAmount":105.71,
                        "vatType":"Reduced",
                        "currency":"GBP"
                    },
                    "totalGrossAmount":{
                        "amount":111,
                        "currency":"GBP"
                    }
                },
                {
                    "from":"2020-09-26T09:00:00+01:00",
                    "to":"2020-09-27T10:00:00+01:00",
                    "ratePlan":{
                        "id":"LND-NONREF-DBL",
                        "code":"NONREF",
                        "name":"Non Refundable",
                        "description":"Pay in advance and safe. If you cancel we well keep the amount of the full stay.",
                        "isSubjectToCityTax":true
                    },
                    "unitGroup":{
                        "id":"LND-DBL",
                        "code":"DBL",
                        "name":"Double",
                        "description":"Big room with balcony, whirlpool and a kingsize bed.",
                        "maxPersons":2
                    },
                    "baseAmount":{
                        "grossAmount":121,
                        "netAmount":115.24,
                        "vatType":"Reduced",
                        "currency":"GBP"
                    },
                    "totalGrossAmount":{
                        "amount":121,
                        "currency":"GBP"
                    }
                }
            ],
            "services":[
                {
                    "service":{
                        "id":"LND-BRKF",
                        "code":"BRKF",
                        "name":"Breakfast",
                        "description":"Enjoy fresh fruit, just-baked viennoiseries, or a hearty morning meal.",
                        "pricingUnit":"Person",
                        "defaultGrossPrice":{
                            "amount":20,
                            "currency":"GBP"
                        }
                    },
                    "count":1,
                    "totalAmount":{
                        "grossAmount":60,
                        "netAmount":50.01,
                        "vatType":"Normal",
                        "currency":"GBP"
                    },
                    "prePaymentAmount":{
                        "amount":60,
                        "currency":"GBP"
                    },
                    "dates":[
                        {
                            "serviceDate":"2020-09-25",
                            "amount":{
                                "grossAmount":20,
                                "netAmount":16.67,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        },
                        {
                            "serviceDate":"2020-09-26",
                            "amount":{
                                "grossAmount":20,
                                "netAmount":16.67,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        },
                        {
                            "serviceDate":"2020-09-27",
                            "amount":{
                                "grossAmount":20,
                                "netAmount":16.67,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        }
                    ]
                },
                {
                    "service":{
                        "id":"LND-WLAN",
                        "code":"WLAN",
                        "name":"High-Speed WLAN",
                        "description":"Upgrade the complimentary internet access to a high speed connection.",
                        "pricingUnit":"Room",
                        "defaultGrossPrice":{
                            "amount":10,
                            "currency":"GBP"
                        }
                    },
                    "count":1,
                    "totalAmount":{
                        "grossAmount":30,
                        "netAmount":24.99,
                        "vatType":"Normal",
                        "currency":"GBP"
                    },
                    "prePaymentAmount":{
                        "amount":30,
                        "currency":"GBP"
                    },
                    "dates":[
                        {
                            "serviceDate":"2020-09-24",
                            "amount":{
                                "grossAmount":10,
                                "netAmount":8.33,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        },
                        {
                            "serviceDate":"2020-09-25",
                            "amount":{
                                "grossAmount":10,
                                "netAmount":8.33,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        },
                        {
                            "serviceDate":"2020-09-26",
                            "amount":{
                                "grossAmount":10,
                                "netAmount":8.33,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        }
                    ]
                }
            ],
            "taxDetails":[
                {
                    "vatType":"Null",
                    "vatPercent":0,
                    "net":{
                        "amount":0,
                        "currency":"GBP"
                    },
                    "tax":{
                        "amount":0,
                        "currency":"GBP"
                    }
                },
                {
                    "vatType":"Reduced",
                    "vatPercent":5,
                    "net":{
                        "amount":339.05,
                        "currency":"GBP"
                    },
                    "tax":{
                        "amount":16.95,
                        "currency":"GBP"
                    }
                },
                {
                    "vatType":"Normal",
                    "vatPercent":20,
                    "net":{
                        "amount":75,
                        "currency":"GBP"
                    },
                    "tax":{
                        "amount":15,
                        "currency":"GBP"
                    }
                },
                {
                    "vatType":"Without",
                    "vatPercent":0,
                    "net":{
                        "amount":0,
                        "currency":"GBP"
                    },
                    "tax":{
                        "amount":0,
                        "currency":"GBP"
                    }
                }
            ],
            "isCorporate":false
        },
        {
            "arrival":"2020-09-24T16:00:00+01:00",
            "departure":"2020-09-27T10:00:00+01:00",
            "minGuaranteeType":"Prepayment",
            "availableUnits":2,
            "totalGrossAmount":{
                "amount":446,
                "currency":"GBP"
            },
            "cancellationFee":{
                "code":"STR",
                "name":"Strict",
                "description":"No free cancellation.",
                "dueDateTime":"2020-09-23T08:24:53.092124+01:00",
                "fee":{
                    "amount":356,
                    "currency":"GBP"
                }
            },
            "noShowFee":{
                "code":"NONREF",
                "fee":{
                    "amount":356,
                    "currency":"GBP"
                }
            },
            "timeSlices":[
                {
                    "from":"2020-09-24T16:00:00+01:00",
                    "to":"2020-09-25T09:00:00+01:00",
                    "ratePlan":{
                        "id":"LND-NONREF-FAMILY",
                        "code":"NONREF",
                        "name":"Non Refundable Family",
                        "description":"Pay in advance and safe. If you cancel we well keep the amount of the full stay.",
                        "isSubjectToCityTax":true
                    },
                    "unitGroup":{
                        "id":"LND-FAMILY",
                        "code":"FAMILY",
                        "name":"Family room",
                        "description":"Big room with balcony, whirlpool and two kingsize beds.",
                        "maxPersons":4
                    },
                    "baseAmount":{
                        "grossAmount":124,
                        "netAmount":118.1,
                        "vatType":"Reduced",
                        "currency":"GBP"
                    },
                    "totalGrossAmount":{
                        "amount":124,
                        "currency":"GBP"
                    }
                },
                {
                    "from":"2020-09-25T09:00:00+01:00",
                    "to":"2020-09-26T09:00:00+01:00",
                    "ratePlan":{
                        "id":"LND-NONREF-FAMILY",
                        "code":"NONREF",
                        "name":"Non Refundable Family",
                        "description":"Pay in advance and safe. If you cancel we well keep the amount of the full stay.",
                        "isSubjectToCityTax":true
                    },
                    "unitGroup":{
                        "id":"LND-FAMILY",
                        "code":"FAMILY",
                        "name":"Family room",
                        "description":"Big room with balcony, whirlpool and two kingsize beds.",
                        "maxPersons":4
                    },
                    "baseAmount":{
                        "grossAmount":111,
                        "netAmount":105.71,
                        "vatType":"Reduced",
                        "currency":"GBP"
                    },
                    "totalGrossAmount":{
                        "amount":111,
                        "currency":"GBP"
                    }
                },
                {
                    "from":"2020-09-26T09:00:00+01:00",
                    "to":"2020-09-27T10:00:00+01:00",
                    "ratePlan":{
                        "id":"LND-NONREF-FAMILY",
                        "code":"NONREF",
                        "name":"Non Refundable Family",
                        "description":"Pay in advance and safe. If you cancel we well keep the amount of the full stay.",
                        "isSubjectToCityTax":true
                    },
                    "unitGroup":{
                        "id":"LND-FAMILY",
                        "code":"FAMILY",
                        "name":"Family room",
                        "description":"Big room with balcony, whirlpool and two kingsize beds.",
                        "maxPersons":4
                    },
                    "baseAmount":{
                        "grossAmount":121,
                        "netAmount":115.24,
                        "vatType":"Reduced",
                        "currency":"GBP"
                    },
                    "totalGrossAmount":{
                        "amount":121,
                        "currency":"GBP"
                    }
                }
            ],
            "services":[
                {
                    "service":{
                        "id":"LND-BRKF",
                        "code":"BRKF",
                        "name":"Breakfast",
                        "description":"Enjoy fresh fruit, just-baked viennoiseries, or a hearty morning meal.",
                        "pricingUnit":"Person",
                        "defaultGrossPrice":{
                            "amount":20,
                            "currency":"GBP"
                        }
                    },
                    "count":1,
                    "totalAmount":{
                        "grossAmount":60,
                        "netAmount":50.01,
                        "vatType":"Normal",
                        "currency":"GBP"
                    },
                    "prePaymentAmount":{
                        "amount":60,
                        "currency":"GBP"
                    },
                    "dates":[
                        {
                            "serviceDate":"2020-09-25",
                            "amount":{
                                "grossAmount":20,
                                "netAmount":16.67,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        },
                        {
                            "serviceDate":"2020-09-26",
                            "amount":{
                                "grossAmount":20,
                                "netAmount":16.67,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        },
                        {
                            "serviceDate":"2020-09-27",
                            "amount":{
                                "grossAmount":20,
                                "netAmount":16.67,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        }
                    ]
                },
                {
                    "service":{
                        "id":"LND-WLAN",
                        "code":"WLAN",
                        "name":"High-Speed WLAN",
                        "description":"Upgrade the complimentary internet access to a high speed connection.",
                        "pricingUnit":"Room",
                        "defaultGrossPrice":{
                            "amount":10,
                            "currency":"GBP"
                        }
                    },
                    "count":1,
                    "totalAmount":{
                        "grossAmount":30,
                        "netAmount":24.99,
                        "vatType":"Normal",
                        "currency":"GBP"
                    },
                    "prePaymentAmount":{
                        "amount":30,
                        "currency":"GBP"
                    },
                    "dates":[
                        {
                            "serviceDate":"2020-09-24",
                            "amount":{
                                "grossAmount":10,
                                "netAmount":8.33,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        },
                        {
                            "serviceDate":"2020-09-25",
                            "amount":{
                                "grossAmount":10,
                                "netAmount":8.33,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        },
                        {
                            "serviceDate":"2020-09-26",
                            "amount":{
                                "grossAmount":10,
                                "netAmount":8.33,
                                "vatType":"Normal",
                                "currency":"GBP"
                            },
                            "isDefaultDate":true,
                            "isMandatory":false
                        }
                    ]
                }
            ],
            "taxDetails":[
                {
                    "vatType":"Null",
                    "vatPercent":0,
                    "net":{
                        "amount":0,
                        "currency":"GBP"
                    },
                    "tax":{
                        "amount":0,
                        "currency":"GBP"
                    }
                },
                {
                    "vatType":"Reduced",
                    "vatPercent":5,
                    "net":{
                        "amount":339.05,
                        "currency":"GBP"
                    },
                    "tax":{
                        "amount":16.95,
                        "currency":"GBP"
                    }
                },
                {
                    "vatType":"Normal",
                    "vatPercent":20,
                    "net":{
                        "amount":75,
                        "currency":"GBP"
                    },
                    "tax":{
                        "amount":15,
                        "currency":"GBP"
                    }
                },
                {
                    "vatType":"Without",
                    "vatPercent":0,
                    "net":{
                        "amount":0,
                        "currency":"GBP"
                    },
                    "tax":{
                        "amount":0,
                        "currency":"GBP"
                    }
                }
            ],
            "isCorporate":false
        }
    ]
}

Next, you amend the reservation by calling the following endpoint.

PUT /booking/v1/reservation-actions/{id}/amend

Example

{
    "arrival":"2020-09-24T17:00:00+02:00",
    "departure":"2020-09-27T11:00:00+02:00",
    "adults":1,
    "requote":true,
    "timeSlices":[
        {
            "ratePlanId":"LND-NONREF-DBL",
            "totalGrossAmount":{
                "amount":124.00,
                "currency":"GBP"
            }
        },
        {
            "ratePlanId":"LND-NONREF-DBL",
            "totalGrossAmount":{
                "amount":111.00,
                "currency":"GBP"
            }
        },
        {
            "ratePlanId":"LND-NONREF-DBL",
            "totalGrossAmount":{
                "amount":121.00,
                "currency":"GBP"
            }
        }
    ]
}

You can also ask to get offers which would typically not be available (for example, because the advanced booking or other restrictions are violated). Add the parameter IncludeUnavailable to true. If you do this, be sure to check the validation messages in the offer response and ensure that you do not overbook the hotel. To book an offer with validation messages, you need to force the system to accept it by using the $force endpoint.

GET /booking/v1/reservations/{id}/offers?includeUnavailabe=true
PUT /booking/v1/reservation-actions/{id}/amend/$force

Late check-out or early check-in

Late check-out or early check-in can be modelled by changing the departure or arrival time of a reservation and increasing the price. Ask for alternative offers for the reservation you want to adjust and specify the desired departure or arrival time. Use the response to construct the payload for the amend and add the additional price for the late check-out or early check-in to the last or first time night, respectively. You could also instead of increasing the price book a pre-defined extra for the respective night.

Bid on room upgrades or set your own price

Similar to the late check-out, setting your price can be done by amending a reservation and passing prices in the time slice/nights. Just like above, you can also add extra services instead of changing the price. It is not possible to set a price for the entire reservation; you always must adjust each and every time slice/night.