GUguesty
[Beta] Basic Fees

List basic fees for listings

Changed on

Returns basic fee configuration (cleaning fee) for the given listing IDs. Listing IDs with no basic fees configured are omitted from the 200 array (not 404). Pass listing IDs as repeated query parameters or a single comma-separated value (maximum 50).

get/basic-fees/listings

Request

  • Base URL
    https://open-api.guesty.com/v1
  • URL
    https://open-api.guesty.com/v1/basic-fees/listings
  • Auth
    API key in header authorization

Query parameters

listingIdsstring[] required

Listing IDs to fetch (maximum 50 per request; for more, split into batches of up to 50). Accepted as repeated parameters (?listingIds=5f8d0d55b54764421b7156c9&listingIds=5f8d0d55b54764421b7156ca) or a single comma-separated value (?listingIds=5f8d0d55b54764421b7156c9,5f8d0d55b54764421b7156ca). Listing IDs with no basic fees configured are omitted from the 200 array (not 404).

[
  "5f8d0d55b54764421b7156c9",
  "5f8d0d55b54764421b7156ca"
]

Response

Basic fee configurations for the requested listings. Listing IDs with no basic fees configured are omitted.

listingIdstring required

Listing id

accountIdstring required

Account id

Example response

[
  {
    "listingId": "5f8d0d55b54764421b7156c9",
    "accountId": "5f8d0d55b54764421b7156c8",
    "cleaningFee": {
      "value": {
        "_id": "5f8d0d55b54764421b7156c9",
        "multiplier": "PER_STAY",
        "formula": 100,
        "valueType": "FIXED"
      }
    },
    "channelConfigurations": [
      {
        "cleaningFee": {
          "value": {
            "_id": "5f8d0d55b54764421b7156c9",
            "multiplier": "PER_STAY",
            "formula": 100,
            "valueType": "FIXED"
          }
        }
      }
    ]
  }
]

Changes