---
title: "Get listing cleaning fee for channel"
method: GET
path: "/basic-fees/listings/{listingId}/channels/{channel}"
tags: ["[Beta] Basic Fees"]
---

# Get listing cleaning fee for channel

`GET /basic-fees/listings/{listingId}/channels/{channel}`

## Request

- Base URL: `https://open-api.guesty.com/v1`
- URL: `https://open-api.guesty.com/v1/basic-fees/listings/{listingId}/channels/{channel}`
- Auth: API key in header `authorization`

Returns the effective cleaning fee for that channel (channel override if present, else listing default). When basic fees are configured for the listing but have neither a listing default nor a channel override, responds 200 without cleaningFee (field omitted). 404 only when the listing has no basic fees configured. There is no markup property — percentage listing markup that applies to cleaning fee is already baked into formula when applicable.

## Path parameters

- `listingId` string, required
- `channel` 'airbnb2' | 'bookingCom' | 'homeaway2' | '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' | 'homesVillasByMarriott' | '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' | 'vrboLite' | 'wander' | 'weski' | 'weChalet' | 'whimstay' | 'zaaer', required

## Response `200`

Effective cleaning fee for the listing on the given channel. When basic fees are configured but have no listing default and no override for this channel, cleaningFee is omitted. Percentage listing markup that applies to cleaning fee is already baked into formula when applicable; there is no separate markup property.

- object
  - `cleaningFee` object: Effective cleaning fee for the listing on this channel (channel override if present, else listing default). Percentage listing markup that applies to cleaning fee is already baked into formula when applicable; there is no separate markup property.
    - `value` object, required: Cleaning fee value details
      - `_id` string: Server-assigned ID of this cleaning-fee value. Present on read responses; omit on write.
      - `multiplier` 'PER_STAY' | 'PER_GUEST' | 'PER_NIGHT' | 'PER_GUEST_PER_NIGHT', required: Always required on this API. FIXED: PER_STAY, PER_NIGHT, PER_GUEST, or PER_GUEST_PER_NIGHT. PERCENTAGE: only PER_STAY.
      - `formula` number, required: FIXED: amount in the listing currency. PERCENTAGE: percent of the accommodation fare.
      - `valueType` 'PERCENTAGE' | 'FIXED', required: Whether formula is a fixed amount (FIXED) or a percent of accommodation fare (PERCENTAGE).
    - `lastUpdated` string, date-time: Last updated timestamp

## Other responses

- `400`: The input provided is invalid.
- `404`: No basic fees are configured for the listing.

## Changes

- **2026-11-03** `3122b8618183`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/guesty/apis/guesty-open-api/changes/basic-fees/listings/:listingId/channels/:channel/get.md)

---

[API](https://skmtc.dev/guesty/apis/guesty-open-api.md) - [All operations](https://skmtc.dev/guesty/apis/guesty-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/guesty/apis/guesty-open-api/revisions/3122b8618183?raw)