Skip to main content

Hotel Availability

Commerce
Shopping
REST API
Booking Solutions

New functionality from the following enhancement: Seasonal Taxes.

Read more

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 Hotel Availability API now includes details about the seasons for a tax in the ChargeList. Taxes that are not enabled for seasons will continue to return the tax details as previously. But for any Taxes that are enabled for seasons, a new TaxSeasonList array will be returned as part of the ChargeList Details, which will contain all the relevant information related to the Seasonal Tax. The TaxAmount and FactorType that are present in the Details element are not applicable for Seasonal Taxes and should be ignored.

The following is a partial response with the ChargeList containing Seasonal Tax information:

{
  "contentLists": {
    "ChargeList": [
      {
        "Details": {
          "Description": "",
          "Frequency": "PerNight",
          "ChargePer": "FlatCharge",
          "TaxAmount": 0,
          "FactorType": "Amount",
          "IsInclusive": false,
          "SortOrder": 3,
          "TaxSeasonList": [
            {
              "SeasonName": "Season 1",
              "StartDate": "2025-01-01T00:00:00",
              "EndDate": "2025-09-30T00:00:00",
              "Amount": 11.75,
              "AmountFactorType": "Amount",
              "MinLengthOfStay": 0,
              "MaxLengthOfStay": 0,
              "MaximumDailyPrice": 0,
              "MinimumDailyPrice": 0
            },
            {
              "SeasonName": "Season 2",
              "StartDate": "2025-10-01T00:00:00",
              "EndDate": "2027-12-31T00:00:00",
              "Amount": 15.00,
              "AmountFactorType": "Amount",
              "MinLengthOfStay": 0,
              "MaxLengthOfStay": 0,
              "MaximumDailyPrice": 0,
              "MinimumDailyPrice": 0
            }
          ]
        }
      }
    ]
  }
}