Skip to main content

Hotel Services

Hotel
Utility
REST API
Hospitality
Try Now

What is it?

Use these APIs to retrieve room and tax information that is managed at the hotel-level in the SynXis CR.

Why use it?

Use these APis to validate the settings that have been configured in the SynXis CR for a specified hotel.

How to use

Retrieve a list of Room Type information for a specified hotel

[GET] /admin/hotels/{id}/roomTypes

{
    "roomTypes": [{
        "code": "SUPK",
        "isActive": "True",
        "name": "Superior Room King Bed"
    }, {
        "code": "SUEX",
        "isActive": "True",
        "name": "Executive Suite King Bed"
    }]
}

Retrieve Room Type information for a specified room type code

[GET] /admin/hotels/{id}/roomTypes/{roomTypeCode}

{
    "code": "SUEX",
    "isActive": "True",
    "name": "Executive Suite King Bed",
    "roomCategory": {
        "code": "Suites",
        "name": "Suites"
    }
}

Retrieve a list of Room Views available for a specified hotel

[GET] /admin/hotels/{id}/roomViews?channelCode=WEB

{
    "roomView": [{
        "code": "20768",
        "description": "English City View",
        "otaDescription": "City view"
    }]
}

Retrieve a list of Room Features available for a specified hotel

[GET] /admin/hotels/{id}/roomFeatures?channelCode=WEB

{
    "roomFeatures": [{
        "chain": {
            "id": "12723",
            "code": "FAMORIM",
            "name": "Sabre Hospitality Chain"
        },
        "code": "91034",
        "description": "Accessible Elevators",
        "otaDescription": "Accessible Elevators"
    }, {
        "chain": {
            "id": "12723",
            "code": "FAMORIM",
            "name": "Sabre Hospitality Chain"
        },
        "code": "10074",
        "description": "Non-smoking",
        "otaDescription": "Non-smoking"
    }, {
        "chain": {
            "id": "12723",
            "code": "FAMORIM",
            "name": "Sabre Hospitality Chain"
        },
        "code": "10051",
        "description": "High speed internet connection",
        "otaDescription": "High speed internet connection"
    }]
}

Retrieve a list of Room Requests available for a specified hotel

[GET] /admin/hotels/{id}/roomRequests?channelCode=WEB

{
    "roomFeatures": [{
        "chain": {
            "id": "12723",
            "code": "FAMORIM",
            "name": "Sabre Hospitality Chain"
        },
        "code": "50161",
        "description": "Accessible room",
        "otaDescription": "Accessible room"
    }, {
        "chain": {
            "id": "12723",
            "code": "FAMORIM",
            "name": "Felipe Training Chain"
        },
        "code": "59002",
        "description": "Near Elevator",
        "otaDescription": "Near Elevator"
    }]
}

Retrieve a list of Taxes specified for a specified hotel

[GET] /admin/hotels/{id}/taxes

{
    "taxes": [{
        "code": "City1-10",
        "name": "City Tax 1-10 Nights",
        "description": "City Tax 1-10 Nights",
        "level": "HotelTax",
        "applyToFreeNights": false,
        "inclusive": true,
        "taxType": "VAT_GST_Tax",
        "chargeType": "Flat",
        "chargeFrequency": "PerStay",
        "validity": {
            "startDate": "2008-02-27T00:00:00",
            "endDate": "2027-09-29T00:00:00"
        },
        "amount": {
            "unitType": "Amount",
            "value": 20.0
        }
    }, {
        "code": "City11",
        "name": "City Tax 11+",
        "description": "City Tax 11+",
        "level": "HotelTax",
        "applyToFreeNights": false,
        "inclusive": true,
        "taxType": "CityTax",
        "chargeType": "Flat",
        "chargeFrequency": "PerNight",
        "validity": {
            "startDate": "2018-03-06T00:00:00",
            "endDate": "2027-09-29T00:00:00"
        },
        "amount": {
            "unitType": "Percent",
            "value": 4.50
        }
    }],
    "pagination": {
        "total": 2,
        "start": 0,
        "size": 2
    }
}

Retrieve Tax information for a specified for a specified tax code

[GET] /admin/hotels/{id}/taxes/{code}

{
    "code": "City11",
    "name": "City Tax 11+",
    "description": "City Tax 11+",
    "level": "HotelTax",
    "applyToFreeNights": false,
    "inclusive": true,
    "taxType": "CityTax",
    "chargeType": "Flat",
    "chargeFrequency": "PerNight",
    "validity": {
        "startDate": "2018-03-06T00:00:00",
        "endDate": "2027-09-29T00:00:00"
    },
    "amount": {
        "unitType": "Percent",
        "value": 4.50
    }
}