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" } } }] } }