2025 December – API update: tax rules support, GET /charge_codes/{id}/basic_taxes

The endpoint now returns a tax_rules array for each linked tax charge code, allowing partners to retrieve tax rules that override the default tax setup. Tax rules support three mutually exclusive rule types:

• Night count based – applies a different tax rate or amount based on the number of nights (e.g. nights 1–5 at 10%, nights 6+ at 5%), using from_nights and to_nights
• Length of stay based – applies based on the total length of stay, using from_los and to_los
• Room type and/or date range based – applies based on specific room types, date ranges, or a combination of both, using room_type_ids, from_date, and to_date

Each tax rule always returns both percentage and flat_amount; one will have a value and the other will be null depending on PMS configuration. If no tax rules are configured, tax_rules returns as an empty array.

Note: tax rules based on rate amount are not supported by this endpoint.

Example response:

{
  "id": 12345,
  "charge_code": "1000",
  "description": "Accommodation",
  "taxes": [
    {
      "is_inclusive": false,
      "charge_code_id": 12346,
      "charge_code": "9000",
      "charge_code_description": "2%-Tax",
      "percentage": "2.0",
      "tax_calculation_rule": "ChargeCodeBaseAmount",
      "amount_type": "FLAT",
      "post_type": "NIGHT",
      "charge_group": "Tax",
      "charge_code_type": "TAX",
      "tax_rules": [
        {
          "percentage": null,
          "flat_amount": "15.0",
          "room_type_ids": [{"id": 1526703}, {"id": 1029383}],
          "from_date": "2025-01-01",
          "to_date": "2025-12-31"
        },
        {
          "percentage": "5.0",
          "flat_amount": null,
          "from_los": 3,
          "to_los": 7
        }
      ]
    }
  ]
}