---
title: "Get unit type (parent unit) level taxes"
method: GET
path: "/taxes/unit-type/{id}"
tags: ["Taxes"]
---

# Get unit type (parent unit) level taxes

`GET /taxes/unit-type/{id}`

Get unit type (parent unit) level taxes

## Path parameters

- `id` string, required

## Response `200`

The unit type level taxes.

- object[]
  - `_id` string
  - `unitTypeId` string
  - `accountId` string, required
  - `type` 'LOCAL_TAX' | 'CITY_TAX' | 'VAT' | 'GOODS_AND_SERVICES_TAX' | 'TOURISM_TAX' | 'OTHER' | 'STATE_TAX' | 'COUNTY_TAX' | 'OCCUPANCY_TAX' | 'TRANSIENT_OCCUPANCY_TAX' | 'HOME_SHARING_TAX' | 'HARMONIZED_SALES_TAX' | 'MINIMUM_ALTERNATE_TAX', required
  - `units` 'PERCENTAGE' | 'FIXED', required
  - `quantifier` 'PER_NIGHT' | 'PER_GUEST' | 'PER_GUEST_PER_NIGHT' | 'PER_STAY', required
  - `appliedOnFees` string[], required
  - `appliedByDefaultOnChannels` string[], required
  - `channelOverrides` object[] — Per-channel customizations for this tax. Each entry allows you to override specific tax settings (such as name, enabled state, or inclusive behavior) for a particular booking channel, without changing the tax's default configuration.
    - `channel` 'manual' | 'airbnb' | 'airbnb2' | 'rentalsUnited' | 'bookingCom' | 'expedia' | 'homeAway' | 'agoda' | 'tripAdvisor' | 'homeaway2' | 'siteMinder' | 'bookingPal' | 'vrboLite' | 'homesVillasByMarriott' | 'aabode' | 'alohacamp' | 'amaSelections' | 'allogio' | 'altoVita' | 'alluraDirect' | 'angells' | 'anystaysCom' | 'awaze' | 'beachguide' | 'belVilla' | 'bluegroundNestpick' | 'bnbFinder' | 'boarding' | 'bookingPalGcm' | 'bookripe' | 'boutiquehomeCom' | 'byndhomesCom' | 'bynd' | 'capitalOne' | 'cockpit' | 'cocoonr' | 'check24' | 'crewDogs' | 'cuddlyNest' | 'desVu' | 'easyReserve' | 'emeraldCoast' | 'etravel' | 'feratel' | 'findRentals' | 'floridaPanhandleCom' | 'floridaRentals' | 'flowOne' | 'getawayGoGo' | 'glampingHub' | 'golfhom' | 'gonesto' | 'googleVacationRentals' | 'got2Go' | 'groupRentals' | 'guestSmiles' | 'hawaiianIslandsCom' | 'helloLanding' | 'hiSite' | 'holidaySwap' | 'holidu' | 'homeToGo' | 'hopper' | 'hostelworld' | 'hotelbeds' | 'hotelsCombined' | 'houfy' | 'housingAnywhere' | 'houseStay' | 'housingPanda' | 'HVN' | 'hyperguest' | 'inntopia' | 'invenioHomes' | 'lakeCom' | 'livily' | 'livjaza' | 'luxico' | 'luxuryEscapes' | 'makeMyTrip' | 'mirai' | 'mrMrsSmith' | 'muchosol' | 'mysaGlobal' | 'nesto' | 'netAffinity' | 'oliversTravels' | 'onefinestay' | 'plumGuide' | 'priceTravelCom' | 'rakutenStayInc' | 'reconline' | 'rentalEscapes' | 'rentalz' | 'renters' | 'reserva' | 'revato' | 'roibos' | 'sabreSynxis' | 'situCom' | 'skiCom' | 'skyesCottages' | 'smilingHouse' | 'smokyMountainCom' | 'soujourn' | 'spacestCom' | 'square' | 'stay' | 'stayHvn' | 'stayLonger' | 'stayOne' | 'staySense' | 'stugaCa' | 'szallas' | 'theDyrt' | 'theMaimonGroup' | 'theQuintessCollection' | 'topVillas' | 'torontoBoutiqueApartments' | 'traveloka' | 'travelStaytion' | 'travelWithAspectCom' | 'tripco' | 'tripCom' | 'tripCom2' | 'traum' | 'tropicalEscape' | 'trustedStays' | 'tuiVillas' | 'vacasa' | 'vacationFinder' | 'vacationRenter' | 'vacayHome' | 'vacayMyWay' | 'viajesElCorteIngles' | 'vidle' | 'villaFinder' | 'villaway' | 'villaTracker' | 'vivreStays' | 'wander' | 'weski' | 'weChalet' | 'whimstay' | 'zaaer', required — The booking channel this override applies to (e.g. Airbnb, Booking.com). Each channel can only appear once per tax.
    - `isEnabled` boolean — Whether this tax is active for the specified channel. When set to false, the tax will not be applied to reservations from this channel. Defaults to true if not provided.
    - `name` string — A custom display name for this tax on the specified channel. If not provided, the tax's default name is used.
    - `isInclusive` boolean — Whether the tax should be treated as inclusive for this channel. If not provided, the tax's default inclusive setting is used.
    - `isAppliedByDefault` boolean — Whether the tax is automatically pre-deducted from the accommodation fare for this channel override. If not provided, the tax's default setting is used. Only allowed when this override's channel is 'airbnb2' or 'manual'. Must be set to true when appliedByDefaultOnChannels is provided.
    - `appliedByDefaultOnChannels` string[]
  - `isDeleted` boolean
  - `amount` number, required
  - `name` string
  - `appliedToAllFees` boolean, required
  - `isAppliedByDefault` boolean, required
  - `conditionalOverrides` object
    - `viewType` 'NIGHTS' | 'DATES' | 'NIGHTS_IN_DATES' | 'LOS', required
    - `rules` object[]
      - `dateRange` object
        - `from` string, required
        - `to` string, required
      - `nightRanges` object[], required
        - `from` number, required
        - `to` number
        - `amount` number, required
    - `maxNightCountToApplyOn` number
  - `channelConfig` object[]
    - `channel` string, required
    - `userConfig` object, required
      - `syncSelection` string, required
  - `isInclusive` boolean

## Other responses

- `400` — The input provided is invalid.

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/versions/7c62644070f2/schema)