Overview

Returns the tax schema of a hotel as normalized static data, independent of the supply provider the rules were learned from. Each entry describes one tax or fee: whether it is already included in the room rate, whether it is a percentage of the rate or a fixed amount, and how fixed amounts scale (per adult and/or per night).

When to Use

• Price transparency - Show guests which taxes and fees apply at a property
• Amount-due-at-property estimates - Excluded taxes are typically collected at the hotel
• Tax auditing - Compare supplier-declared taxes against the reference schema

Notes

• Fixed amounts are expressed in USD
• Percentage rates apply to the room rate (e.g. 14.62 means 14.62%)
• The schema is learned by an offline pipeline; hotels without learned data return 404
• Enterprise accounts also receive category, chargeType, and payAtProperty on each tax. payAtProperty is always the opposite of included. When the hotel declared the rule, an enterprise response may also include appliedPer, appliedOn, validFrom, and validTo