Skip to main content

Charge List

Charge List

The ChargeList provides a list of taxes and fees that are used in the pricing calculations. The ChargeList will be included in the response if the request contains content=full.

ParameterDescriptionType
CodeCode associated with a fee or taxString
LevelLevel is used to convey the charge level 
Values: Hotel, Package, Rate, Room
String
NameName associated with the fee or taxString
TypeType of the tax or fee 
Values: BedTax, CityHotelFee, CityTax, CountyTax, EnergyTax, FederalTax, FoodBeverageTax, LodgingTax, MaintenanceFee, MiscellaneousFee, MiscellaneousTax, OccupancyTax, PackageFee, ResortFee, RoomTax, SalesTax, ServiceCharge, StateTax,Surcharge, TotalTax, TourismTax, VAT_GST_Tax
String
Details/@DescriptionDescription of the tax or fee.String
Details/@FrequencyFrequency of the tax or fee.String
Details/@ChargePerSpecifies how the tax is charged. 
Values: FlatCharge, PerPerson, PerAdult, PerChild
String
Details/@TaxAmountConfigured tax amount to be charged, either as a percent or fixed amount.String
Details/@FactorTypeConveys the factor type of the tax. 
Values: Amount, Percentage
String
Details/@IsInclusiveIf true, indicates that the tax is inclusive.Boolean
Details/@SortOrderSort order of the tax within its level.String

 

Successful Response (partial)

A successful response will include an optional contentLists/ChargeList node containg a list of charge types if the Request includes content=full.

Additionally, if a charge applies to a product, it will also appear under the productAvailability/Prices node.

 

{
    "contentLists": {
        "ChargeList": [{
            "Details": {
                "Description": "CITYTAX",
                "Frequency": "PerNight",
                "ChargePer": "FlatCharge",
                "TaxAmount": 10,
                "FactorType": "Amount",
                "IsInclusive": false,
                "SortOrder": 6
            },
            "Code": "CITYTAX",
            "Level": "Hotel",
            "Name": "CITYTAX",
            "Type": "CityTax"
        }, {
            "Details": {
                "Description": "Resort Fee",
                "Frequency": "PerNight",
                "ChargePer": "FlatCharge",
                "TaxAmount": 8.99,
                "FactorType": "Amount",
                "IsInclusive": false,
                "SortOrder": 8
            },
            "Code": "Resort Fee",
            "Level": "Hotel",
            "Name": "Resort Fee",
            "Type": "ResortFee"
        }, {
            "Details": {
                "Description": "State Tax Description",
                "Frequency": "PerNight",
                "ChargePer": "FlatCharge",
                "TaxAmount": 11,
                "FactorType": "Percentage",
                "IsInclusive": false,
                "SortOrder": 3
            },
            "Code": "State",
            "Level": "Rate",
            "Name": "State Tax",
            "Type": "StateTax"
        }, {
            "Details": {
                "Description": "LodgingTAX",
                "Frequency": "PerNight",
                "ChargePer": "FlatCharge",
                "TaxAmount": 7,
                "FactorType": "Amount",
                "IsInclusive": false,
                "SortOrder": 10
            },
            "Code": "LodgingTAX",
            "Level": "Room",
            "Name": "LodgingTAX",
            "Type": "LodgingTax"
        }]
    },
    "productAvailability": {
        "Prices": [{
            "Product": {
                "Prices": {
                    "Total": {
                        "Price": {
                            "Fees": {
                                "BreakDown": [{
                                    "Amount": 8.99,
                                    "Code": "Resort Fee"
                                }, {
                                    "Amount": 2.08,
                                    "Code": "CITYHOTELFEE"
                                }],
                                "Amount": 11.07,
                                "StayFeesAmount": 2.08
                            },
                            "Tax": {
                                "BreakDown": [{
                                    "Amount": 10,
                                    "Code": "CITYTAX"
                                }, {
                                    "Amount": 3,
                                    "Code": "CountryTax"
                                }, {
                                    "Amount": 6.1,
                                    "Code": "Service Char"
                                }],
                                "Amount": 19.1
                            },
                            "Total": {
                                "Amount": 180,
                                "AmountWithTaxesFees": 210.17,
                                "AmountWithInclusiveTaxes": 180
                            },
                            "Amount": 180,
                            "CurrencyCode": "USD"
                        }
                    },
                    "TaxesFeesIncluded": false
                },
                "Rate": {
                    "Code": "COUPONPROMO"
                },
                "Room": {
                    "Code": "SUPK"
                }
            }
        }]
    }
}