---
title: "Get listing level channel commission"
method: GET
path: "/channel-commissions-v2/unit-type/{unitTypeId}"
tags: ["Channel Commission"]
---

# Get listing level channel commission

`GET /channel-commissions-v2/unit-type/{unitTypeId}`

## Request

- Base URL: `https://open-api.guesty.com/v1`
- URL: `https://open-api.guesty.com/v1/channel-commissions-v2/unit-type/{unitTypeId}`
- Auth: API key in header `authorization`

Returns channel commission entries stored specifically for the given listing (unit type).

This does not resolve account-level inheritance — it returns only listing-level stored values. Each item includes `levelEntityType` set to `UNIT_TYPE`. When no listing-level commissions exist, the response is an empty array. If `unitTypeId` is a sub-unit, it is **remapped to the parent unit type before lookup** (sub-units are not rejected with 400 on this path). PUT `/unit-type/{unitTypeId}` does **not** remap — it stores under the ID you send — so prefer the parent unit type ID when writing so GET and PUT address the same listing-level commissions. Use the `/actual` endpoint to get the commissions that currently apply based on the listing level configuration.

## Path parameters

- `unitTypeId` string, required

## Response `200`

Listing-level channel commission entries, or an empty array when none are stored

- object[]
  - `_id` string: ID of this channel commission entry. Use this value as `channelCommissionId` on PATCH and DELETE.
  - `commission` object: Commission percentage and which charges it applies to. Omitted when no commission is set.
    - `value` number, required: Commission percentage (0–100)
    - `of` string[], required: Which charges the commission applies to (for example `ACCOMMODATION_FARE`, `CLEANING_FEE`, `PAYOUT`)
  - `tax` number: Tax percentage on the channel commission (0–100). Omitted when no tax is set.
  - `source` string, required: Booking source within the channel. Often the same as `channel` for direct channels; can differ for channel managers.
  - `channel` string, required: Booking channel name (for example `bookingCom`, `airbnb2`, `homeaway2`, or `manual`)
  - `isPreDeduct` boolean: When `true`, Guesty automatically deducts the channel commission from the host payout for this source. Applies only to the `manual` channel. Omitted or `false` when not used.
  - `levelEntityType` 'ACCOUNT' | 'UNIT_TYPE', required: Where this commission comes from: `ACCOUNT` for account settings, or `UNIT_TYPE` for listing settings

## Other responses

- `400`: The request is invalid. Common cause: `unitTypeId` is not a valid ID.

## Changes

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

[Operation history](https://skmtc.dev/guesty/apis/guesty-open-api/changes/channel-commissions-v2/unit-type/:unitTypeId/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)