GUguesty
Channel Commission

Get account level channel commission

Changed on

Returns all account-level channel commission entries for the authenticated account.

Each item includes commission percentage, tax, channel/source, and levelEntityType set to ACCOUNT. Returns an empty array when no account-level configuration exists.

get/channel-commissions-v2/account

Request

  • Base URL
    https://open-api.guesty.com/v1
  • URL
    https://open-api.guesty.com/v1/channel-commissions-v2/account
  • Auth
    API key in header authorization

Response

Account-level channel commission entries, or an empty array

_idstring

ID of this channel commission entry. Use this value as channelCommissionId on PATCH and DELETE.

taxnumber

Tax percentage on the channel commission (0–100). Omitted when no tax is set.

sourcestring required

Booking source within the channel. Often the same as channel for direct channels; can differ for channel managers.

channelstring required

Booking channel name (for example bookingCom, airbnb2, homeaway2, or manual)

isPreDeductboolean

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

Example response

[
  {
    "_id": "5f3f7b2f5d7b9b001f6f6c9d",
    "commission": {
      "value": 10,
      "of": [
        "PAYOUT"
      ]
    },
    "tax": 10,
    "source": "homeaway2",
    "channel": "homeaway2",
    "levelEntityType": "ACCOUNT"
  }
]

Changes

  • 3122b8618183Revision changes
    • info

      api operation id ChannelCommissionController_getAccountChannelCommission1 removed and replaced with ChannelCommissionsOpenApiController_getAccountLevelChannelCommissions

    • info

      added the media type application/json for the response with the status