Retrieve Property Charge Meta

This endpoint allows clients to obtain metadata regarding the charges associated with a specific property. This API facilitates access to essential information about the types and categories of charges that can be applied to a property, supporting effective charge management and configuration.

---

Endpoint

GET

https://connect-sandbox.su-api.com/SUAPI/jservice/bdc/property/charges/retrieveChargesMeta

---

Response

Sample Success Response

{
  "Status": "Success",
  "Message": "Successfully fetch details",
  "Warnings": "",
  "Ruid": "84baba44-7339-4b23-bcde-cd91f1f074f6",
  "Data": [
    {
      "charge_type_id": "CITYTAX",
      "ota_fee_tax_types": [3],
      "charge_category": "LOCALITY_CHARGES"
    },
    {
      "charge_type_id": "RESORTFEE",
      "ota_fee_tax_types": [12],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "TAX",
      "ota_fee_tax_types": [13, 17],
      "charge_category": "TAXES"
    },
    {
      "charge_type_id": "SERVICECHARGE",
      "ota_fee_tax_types": [14],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "TOURISMFEE",
      "ota_fee_tax_types": [18],
      "charge_category": "LOCALITY_CHARGES"
    },
    {
      "charge_type_id": "GOODSSERVICESTAX",
      "ota_fee_tax_types": [35],
      "charge_category": "TAXES"
    },
    {
      "charge_type_id": "VAT",
      "ota_fee_tax_types": [36, 19],
      "charge_category": "TAXES"
    },
    {
      "charge_type_id": "GOVERNMENTTAX",
      "ota_fee_tax_types": [46],
      "charge_category": "LOCALITY_CHARGES"
    },
    {
      "charge_type_id": "ENVIRONMENTFEE",
      "booking_extended_legacy_code": [5000],
      "charge_category": "LOCALITY_CHARGES"
    },
    {
      "charge_type_id": "SPATAX",
      "booking_extended_legacy_code": [5001],
      "charge_category": "LOCALITY_CHARGES"
    },
    {
      "charge_type_id": "HOTSPRINGTAX",
      "booking_extended_legacy_code": [5002],
      "charge_category": "LOCALITY_CHARGES"
    },
    {
      "charge_type_id": "MUNICIPALITYFEE",
      "booking_extended_legacy_code": [5003],
      "charge_category": "LOCALITY_CHARGES"
    },
    {
      "charge_type_id": "RESIDENTIALTAX",
      "booking_extended_legacy_code": [5004],
      "charge_category": "LOCALITY_CHARGES"
    },
    {
      "charge_type_id": "CITYTICKET",
      "booking_extended_legacy_code": [5005],
      "charge_category": "LOCALITY_CHARGES"
    },
    {
      "charge_type_id": "HERITAGECHARGE",
      "booking_extended_legacy_code": [5006],
      "charge_category": "LOCALITY_CHARGES"
    },
    {
      "charge_type_id": "FITNESSTAX",
      "booking_extended_legacy_code": [5007],
      "charge_category": "LOCALITY_CHARGES"
    },
    {
      "charge_type_id": "LOCALCOUNCILTAX",
      "booking_extended_legacy_code": [5008],
      "charge_category": "LOCALITY_CHARGES"
    },
    {
      "charge_type_id": "CLEANINGFEE",
      "booking_extended_legacy_code": [5009],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "TOWELFEE",
      "booking_extended_legacy_code": [5010],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "ELECTRICITYFEE",
      "booking_extended_legacy_code": [5011],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "BEDLINEN",
      "booking_extended_legacy_code": [5012],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "GASFEE",
      "booking_extended_legacy_code": [5013],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "OILFEE",
      "booking_extended_legacy_code": [5014],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "WOODFEE",
      "booking_extended_legacy_code": [5015],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "WATERFEE",
      "booking_extended_legacy_code": [5016],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "TRANSFERFEE",
      "booking_extended_legacy_code": [5017],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "LINENPACKAGEFEE",
      "booking_extended_legacy_code": [5018],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "HEATINGFEE",
      "booking_extended_legacy_code": [5019],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "AIRCONDITIONINGFEE",
      "booking_extended_legacy_code": [5020],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "KITCHENLINNENFEE",
      "booking_extended_legacy_code": [5021],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "HOUSEKEEPINGFEE",
      "booking_extended_legacy_code": [5022],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "AIRPORTSHUTTLEFEE",
      "booking_extended_legacy_code": [5023],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "SHUTTLEBOATFEE",
      "booking_extended_legacy_code": [5024],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "SEAPLANEFEE",
      "booking_extended_legacy_code": [5025],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "SKIPASS",
      "booking_extended_legacy_code": [5026],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "WRISTBANDFEE",
      "booking_extended_legacy_code": [5028],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "VISASUPPORTFEE",
      "booking_extended_legacy_code": [5029],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "WATERPARKFEE",
      "booking_extended_legacy_code": [5030],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "CLUBCARDFEE",
      "booking_extended_legacy_code": [5031],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "CONSERVATIONFEE",
      "booking_extended_legacy_code": [5032],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "CREDITCARDFEE",
      "booking_extended_legacy_code": [5033],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "PETFEE",
      "booking_extended_legacy_code": [5034],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "INTERNETFEE",
      "booking_extended_legacy_code": [5035],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "PARKINGFEE",
      "booking_extended_legacy_code": [5036],
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "SERVICECHARGE_ASIA",
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "LAST_SERVICECHARGE",
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "GALADINNERFEE",
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "GOODSSERVICESFLOODTAX",
      "charge_category": "TAXES"
    },
    {
      "charge_type_id": "GOVERNMENTCHARGE",
      "charge_category": "TAXES"
    },
    {
      "charge_type_id": "SUSTAINABILITYFEE",
      "charge_category": "LOCALITY_CHARGES"
    },
    {
      "charge_type_id": "LOCALITYCONSERVATIONFEE",
      "charge_category": "LOCALITY_CHARGES"
    },
    {
      "charge_type_id": "SPA",
      "charge_category": "FACILITY_CHARGES"
    },
    {
      "charge_type_id": "HOTSPRINGBATH",
      "charge_category": "FACILITY_CHARGES"
    },
    {
      "charge_type_id": "POOL",
      "charge_category": "FACILITY_CHARGES"
    },
    {
      "charge_type_id": "LOUNGE",
      "charge_category": "FACILITY_CHARGES"
    },
    {
      "charge_type_id": "DESTINATIONCHARGE",
      "charge_category": "PROPERTY_CHARGES"
    },
    {
      "charge_type_id": "DESTINATIONTAX",
      "charge_category": "LOCALITY_CHARGES"
    }
  ]
}

Success Response Body Elements

Status string

Indicates the result of the API call.

Will be "Success" for successful operations.

---

Message string

A message receives within the response body. This will generally be an empty string if no additional information is needed.

---

Ruid string

Specifies the unique request ID.

You can share this ID with Booking.com customer support when you run into an issue. This can help in understanding what went wrong.

---

Data array

An array of charge data, each item containing details about charge types, categories, and other associated information (for example, tax types, legacy codes).

---

charge_type_id string

The identifier for the charge type.

Enum:

• SERVICECHARGE_ASIA

• SERVICECHARGE

• RESORTFEE

• CLEANINGFEE

• TOWELFEE

• ELECTRICITYFEE

• BEDLINEN

• GASFEE

• OILFEE

• WOODFEE

• WATERFEE

• DESTINATIONFEE

• ENVIRONMENTFEE

• SPATAX

• TRANSFERFEE

• VAT

• CITYTAX

• TAX

• DAMAGEDEPOSIT

• LINENPACKAGEFEE

• HEATINGFEE

• AIRCONDITIONINGFEE

• KITCHENLINNENFEE

• HOUSEKEEPINGFEE

• CLUBCARDFEE

• PETFEE

• INTERNETFEE

• PARKINGFEE

• HOTSPRINGTAX

• MUNICIPALITYFEE

• TOURISMFEE

• RESIDENTIALTAX

• GOODSSERVICESTAX

• HERITAGECHARGE

• GOVERNMENTTAX

• LOCALCOUNCILTAX

• GOVERNMENTCHARGE

• LOCALITYCONSERVATIONFEE

• LAST_SERVICECHARGE

• AIRPORTSHUTTLEFEE

• SHUTTLEBOATFEE

• GALADINNERFEE

• SEAPLANEFEE

• SKIPASS

• FINALCLEANINGFEE

• WRISTBANDFEE

• VISASUPPORTFEE

• WATERPARKFEE

• CONSERVATIONFEE

• CREDITCARDFEE

• CITYTICKET

• FITNESSTAX

• GOODSSERVICESFLOODTAX

• SUSTAINABILITYFEE

• SPA

• HOTSPRINGBATH

• POOL

• LOUNGE

• DESTINATIONCHARGE

• DESTINATIONTAX

ota_fee_tax_types array of integers

An array of OTA fee tax type identifiers associated with the charge type.

charge_category string

The category of the charge.

Enum:

• NET_ROOM_PRICE

• TAXES

• LOCALITY_CHARGES

• PROPERTY_CHARGES

• FACILITY_CHARGES

booking_extended_legacy_code array of integers

An array of legacy codes associated with the booking for certain charge types.

optional, present in some objects.

---

Errors

Sample Error Response 1

{
   "Errors": [
       {
           "Code": "400",
           "ShortText": "HotelCode: Invalid HotelCode ('AWSTEST')"
       }
   ],
   "Status": "Fail"
}

Sample Error Response 2

{
   "Errors": [
       {
           "Code": "573",
           "ShortText": "channel-mapping not found for this property!"
       }
   ],
   "Status": "Fail"
}

Sample Error Response 3

{
   "Status": "Fail",
   "Errors": [],
   "Message": "Authorization error: UNAUTHORIZED",
   "Ruid": "8949f840-7dff-4f69-b71c-fafea0870feb",
   "Data": {}
}

---

Error Response Body Elements

Status string

Indicates the result of the API call, which will be always "Fail" in case of an error response.

---

Error array

Array that contains details about any errors that occurred during the API call. Each object in the Errors array contains the following properties:

Code string

Specific error code that helps identify the type of error.

For example: "400" indicates a bad request.

ShortText string

A short description of the error.

---

Message string

A message providing more information about the error.

---

Ruid string

Specifies the unique request ID.

You can share this ID with Booking.com customer support when you run into an issue. This can help in understanding what went wrong.

In the case where a RUID (Request Unique Identifier) is provided by Booking.com, it will be displayed in the response. If no RUID is received, the field will be left blank.