---
title: "getTaxesAndFees"
method: GET
path: "/getTaxesAndFees"
tags: ["Taxes and Fees"]
---

# getTaxesAndFees

`GET /getTaxesAndFees`

Returns the taxes and fees set for the property. Read the [Rate-Based tax (Dynamic Tax) guide](https://myfrontdesk.cloudbeds.com/hc/en-us/articles/360014103514-rate-based-tax-dynamic-tax) to understand its usage.

## Query parameters

- `propertyID` string
- `includeDeleted` boolean
- `includeExpired` boolean
- `includeCustomItemTaxes` boolean
- `availableFor` 'product' | 'rate' | 'fee' | 'tax' | 'custom_item' | 'payment'
- `sourceId` string
- `isRootSource` boolean
- `isHotelCollectBooking` boolean
- `productId` string
- `addonId` string

## Response `200`

200 Response

- GetTaxesAndFeesResponse
  - `success` boolean — Returns if the request could be completed
  - `message` string, nullable — To be used in case any error occurs (if success = false). If success = true, it does not exist.
  - `data` object[], nullable — Details for the taxes and fees. If success = false, it may not exist.
    - `type` 'fee' | 'tax' — Type. Fee or tax.
    - `feeID` string, nullable — Fee's unique identifier. Only exists if type = fee.
    - `taxID` string, nullable — Tax's unique identifier. Only exists if type = tax.
    - `name` string — Name
    - `code` string — Code
    - `kind` string, nullable — Tax kind. Currently supports "vat", "municipal_tax" or null. Only exists if type = tax.
    - `amount` union — Amount
      - string
      - number
    - `amountAdult` union — Amount charged per adult. Only applicable if amountType = fixed_per_person (Per Person Per Night)
      - string
      - number
    - `amountChild` union — Amount charged per children. Only applicable if amountType = fixed_per_person (Per Person Per Night)
      - string
      - number
    - `amountRateBased` object[], nullable — Rules defined for Rate-Based taxes/fees. Only applicable if amountType = percentage_rate_based (Rate-based)
      - `rate` union — Maximum rate for which this amount is valid
        - string
        - number
      - `percentage` union — Percentage applied for the rate
        - string
        - number
    - `amountType` 'percentage' | 'fixed' | 'fixed_per_person' | 'fixed_per_accomodation' | 'fixed_per_reservation' | 'percentage_rate_based' — Amount type. They mean:<br/> <table> <tr><th>Value</th><th>Meaning</th></tr> <tr><td>percentage</td><td>Percentage of Total Amount</td></tr> <tr><td>fixed</td><td>Fixed per Room Night / Item</td></tr> <tr><td>fixed_per_person</td><td>Fixed per Person per Night</td></tr> <tr><td>fixed_per_accomodation</td><td>Fixed per Accomodation</td></tr> <tr><td>fixed_per_reservation</td><td>Fixed per Reservation</td></tr> <tr><td>percentage_rate_based</td><td>Rate-based</td></tr> </table>
    - `availableFor` string[] — Where this tax/fee is available?<br/>They mean:<br/> <table> <tr><th>Value</th><th>Meaning</th></tr> <tr><td>product</td><td>Items</td></tr> <tr><td>rate</td><td>Reservations</td></tr> <tr><td>fee</td><td>Fees -- this tax is charged on top of some fees</td></tr> <tr><td>custom_item</td><td>Custom item - this tax was charged for a custom item</td></tr> </table>
    - `feesCharged` string[], nullable — List of Fee IDs charged by the current tax (tax-on-fee). Only exists if type = tax.
    - `taxesCharged` string[], nullable — List of Tax IDs charged by the current tax (tax-on-tax). Only exists if type = tax.
    - `inclusiveOrExclusive` 'inclusive' | 'exclusive' — If this tax/fee is inclusive or exclusive
    - `isDeleted` boolean — Flag indicating if tax was deleted from the system
    - `childId` string — ID of the tax or fee that replaced current one
    - `createdAt` string — Date when tax or fee was created in the system
    - `expiredAt` string — Date when tax or fee was expired
    - `roomTypes` object[], nullable — Room types this tax/fee applies to
      - `roomTypeID` string — Room type's unique identifier
      - `roomTypeName` string — Room type name
    - `dateRanges` object[], nullable — Date ranges when this tax/fee is applicable
      - `range` string — ISO 8601 date range. It can be in the format YYYY-MM-DD/YYYY-MM-DD or YYYY-MM-DD/ (to indicate that the end date is not defined). In case of empty year the format is --MM-DD/--MM-DD
      - `amount` union — Amount
        - string
        - number
      - `amountAdult` union — Amount charged per adult. Only applicable if amountType = fixed_per_person (Per Person Per Night)
        - string
        - number
      - `amountChild` union — Amount charged per children. Only applicable if amountType = fixed_per_person (Per Person Per Night)
        - string
        - number
      - `maxLength` union — Maximum amount of nights where this applies. Only applicable if amountType = fixed_per_person (Per Person Per Night)
        - string
        - number
      - `amountRateBased` object[], nullable — Rules defined for Rate-Based taxes/fees. Only applicable if amountType = percentage_rate_based (Rate-based)
        - `rate` union — Maximum rate for which this amount is valid
          - string
          - number
        - `percentage` union — Percentage applied for the rate
          - string
          - number
      - `lengthOfStaySettings` union — Length of Stay configuration settings specific to this date range. Returns object when settings exist, empty array [] when no settings configured.
        - object
          - `applicationType` 'progressive_application' | 'retroactive_adjustment', nullable — Application type for Length of Stay rules
          - `ranges` object[], nullable — Night-based ranges for Length of Stay configuration
            - `minimumNights` integer — Minimum number of nights required for this range
            - `maximumNights` integer, nullable — Maximum number of nights for this range (null means no limit)
            - `amount` union — Amount for this range
              - …
            - `amountAdult` union — Amount per adult for this range
              - …
            - `amountChild` union — Amount per child for this range
              - …
            - `amountRateBased` object[], nullable — Rate-based amounts for this range
              - …
        - object[]
          - `applicationType` 'progressive_application' | 'retroactive_adjustment', nullable — Application type for Length of Stay rules
          - `ranges` object[], nullable — Night-based ranges for Length of Stay configuration
            - `minimumNights` integer — Minimum number of nights required for this range
            - `maximumNights` integer, nullable — Maximum number of nights for this range (null means no limit)
            - `amount` union — Amount for this range
              - …
            - `amountAdult` union — Amount per adult for this range
              - …
            - `amountChild` union — Amount per child for this range
              - …
            - `amountRateBased` object[], nullable — Rate-based amounts for this range
              - …
    - `lengthOfStaySettings` union — Length of Stay configuration settings. Returns object when settings exist, empty array [] when no settings configured.
      - object
        - `applicationType` 'progressive_application' | 'retroactive_adjustment', nullable — Application type for Length of Stay rules:<br/> <table> <tr><th>Value</th><th>Meaning</th></tr> <tr><td>progressive_application</td><td>Apply tax/fee when minimum nights are reached</td></tr> <tr><td>retroactive_adjustment</td><td>Apply adjustments retroactively when conditions are met</td></tr> </table>
        - `ranges` object[], nullable — Night-based ranges for Length of Stay configuration
          - `minimumNights` union — Minimum number of nights required for this range
            - string
            - number
          - `maximumNights` union — Maximum number of nights for this range (null means no limit)
            - string
            - number
          - `amount` union — Amount for this range (uses same amountType as the parent tax/fee)
            - string
            - number
          - `amountAdult` union — Amount per adult for this range (uses same amountType as the parent tax/fee)
            - string
            - number
          - `amountChild` union — Amount per child for this range (uses same amountType as the parent tax/fee)
            - string
            - number
          - `amountRateBased` object[], nullable — Rate-based amounts for this range (uses same amountType as the parent tax/fee)
            - `rate` union — Maximum rate for which this percentage is valid
              - …
            - `percentage` union — Percentage applied for the rate
              - …
      - object[]
        - `applicationType` 'progressive_application' | 'retroactive_adjustment', nullable — Application type for Length of Stay rules:<br/> <table> <tr><th>Value</th><th>Meaning</th></tr> <tr><td>progressive_application</td><td>Apply tax/fee when minimum nights are reached</td></tr> <tr><td>retroactive_adjustment</td><td>Apply adjustments retroactively when conditions are met</td></tr> </table>
        - `ranges` object[], nullable — Night-based ranges for Length of Stay configuration
          - `minimumNights` union — Minimum number of nights required for this range
            - string
            - number
          - `maximumNights` union — Maximum number of nights for this range (null means no limit)
            - string
            - number
          - `amount` union — Amount for this range (uses same amountType as the parent tax/fee)
            - string
            - number
          - `amountAdult` union — Amount per adult for this range (uses same amountType as the parent tax/fee)
            - string
            - number
          - `amountChild` union — Amount per child for this range (uses same amountType as the parent tax/fee)
            - string
            - number
          - `amountRateBased` object[], nullable — Rate-based amounts for this range (uses same amountType as the parent tax/fee)
            - `rate` union — Maximum rate for which this percentage is valid
              - …
            - `percentage` union — Percentage applied for the rate
              - …
  - `total` integer, nullable — Total number of results

---

[API](https://skmtc.net/cloudbeds/apis/cloudbeds-api.md) · [All operations](https://skmtc.net/cloudbeds/apis/cloudbeds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudbeds/cloudbeds-api/revisions/2faa857793e8/schema)