Manage Taxes

Enhanced by the following feature: Tax Seasons – Channelized Descriptions.

Tax Seasons – Channelized Descriptions (FEA105768)

The Manage Taxes API has been enhanced to include the ability to manage Tax Season description translations. The following endpoint operations have been added to support viewing, creating and deleting Tax Season description translations:

Operation	Endpoint	Description
POST	/v1/api/hotel/{hotelID}/taxes/{taxCode}/channelLanguageDescriptions	Create translations for tax seasons.
GET	/v1/api/hotel/{hotelID}/taxes/{taxCode}/channelLanguageDescriptions	Returns seasonal translations for a tax.
DELETE	/v1/api/hotel/{hotelID}/taxes/{taxCode}/channelLanguageDescriptions	Delete tax season translations.

Additionally, we have also enhanced the Manage Taxes API to support the Tax By Price Range and Tax By LOS configurations that can be setup on either the Tax or Tax Season. The attribute action can specify whether you are creating/modifying by passing a value of “AddEdit”, or you can remove the configuration by passing a value of “UnAssign”.

The following endpoint operations were enhanced for this:

Operation	Endpoint	Description
POST	/v1/api/admin/tax	Create tax or fee
PATCH	/v1/api/admin/tax	Update tax or fee

The following is a partial sample of the request for Tax By Price Range (TaxByDailyPriceRange) and Tax By LOS (TaxByLengthOfStay):

{
	...
	"TaxByDailyPriceRange": {
		"minimumPrice": 49.89,
		"maximumPrice": 269.99,
		"action": "AddEdit"
	},
	"TaxByLengthOfStay": {
		"min": 1,
		"max": 9,
		"action": "UnAssign"
	},
	...
}

New functionality from the following enhancement: Seasonal Taxes.

Seasonal Taxes (FEA99064)

With the introduction of Seasonal Taxes, changes have been made to APIs that impact the management of taxes and shopping for room availability. The Manage Taxes API now contains five new endpoints related to Seasonal Taxes:

Operation	Endpoint	Description
POST	/v1/api/admin/tax/{taxCode}/seasons	Create seasons for a tax
PATCH	/v1/api/admin/tax/{taxCode}/seasons	Update seasons for a tax
DELETE	/v1/api/admin/tax/{taxCode}/season/cancel	Delete seasons for a tax
GET	/v1/api/admin/hotel/{hotelID}/taxes/{taxCode}/seasons	Retrieve seasons for a specific tax
GET	/v1/api/admin/hotel/{hotelID}/tax/seasons	Retrieve seasons for all taxes for a hotel

Additionally, the following existing endpoints were enhanced to allow you to set, or retrieve, if a Tax is enabled for seasons. The new optional multiSeason attribute (boolean data type) will have a false value by default.

Operation	Endpoint	Description
GET	/v1/api/admin/hotels/{id}/taxes	Retrieve a list of taxes configured for a specific hotel
GET	/v1/api/admin/hotels/{id}/taxes/{code}	Retrieve a specific tax configuration for a hotel
POST	/v1/api/admin/tax	Create tax or fee configured for a specific hotel
PATCH	/v1/api/admin/tax	Update tax or fee configured for a specific hotel

10.37 | November 16, 2025

Tax Seasons – Channelized Descriptions (FEA105768)

10.36 | August 07, 2025

Seasonal Taxes (FEA99064)