Retrieving charges metadata
Use the charges meta endpoint to retrieve a full list of charge types supported by Charges API, their corresponding OTA codes, and the charge category they apply to.
List of charges is mostly static
The meta endpoint returns a list of all Booking.com supported charges and their details. Updates to this list are infrequent but can happen. Use this endpoint to get up-to-date information and pick up any newly introduced facilities at Booking.com.
Retrieving charges metadata
Use this endpoint to retrieve Booking.com supported charges and their details.
GET
https://supply-xml.booking.com/charges-api/meta
To view the open API specification for the Charges meta endpoint, see Retrieve charges meta endpoint.
Response parameters
The following table describes the response elements:
| Parameter | Description | Type | Notes |
|---|---|---|---|
data | Root element | object | |
> charge_type_id | The charge ID that is used in Charges API. | string | |
> ota_fee_tax_types | Legacy OTA Fee Tax Type Codes (FTT). | array of integer | In rare cases there are two historical type codes for one modern type. |
> booking_extended_legacy_code | Legacy Booking.com Extended Fee Tax Type Codes (FTT). | array of integer | |
> charge_category | Charge category as used in the charge configuration base. | string | The category includes: - Net price - Taxes - Locality taxes - Property charges |
> discontinued | Indicates if a charge is discontinued. Once a charge type is discontinued, it cannot be created or updated, only deleted. | boolean | |
> discontinuation_notice | In the case that a charge type is discontinued, this will provide information about what to use instead or why it was discontinued. | string | |
> allowed_charge_modes | Lists the modes that this charge type supports. | list of strings |
Response body example
Click to view an example response from the meta endpoint. This is an example and is not the source of truth. To retrieve an up-to-date list of all charge types and their details, implement the meta endpoint.
{ "data": [ { "charge_type_id": "CITYTAX", "ota_fee_tax_types": [ 3 ], "charge_category": "LOCALITY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "RESORTFEE", "ota_fee_tax_types": [ 12 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "TAX", "ota_fee_tax_types": [ 13, 17 ], "charge_category": "TAXES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "SERVICECHARGE", "ota_fee_tax_types": [ 14 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "TOURISMFEE", "ota_fee_tax_types": [ 18 ], "charge_category": "LOCALITY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "GOODSSERVICESTAX", "ota_fee_tax_types": [ 35 ], "charge_category": "TAXES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "VAT", "ota_fee_tax_types": [ 36, 19 ], "charge_category": "TAXES", "allowed_charge_modes": [ "PERCENTAGE" ], "discontinued": false }, { "charge_type_id": "GOVERNMENTTAX", "ota_fee_tax_types": [ 46 ], "charge_category": "LOCALITY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "DESTINATIONFEE", "ota_fee_tax_types": [ 55 ], "charge_category": "LOCALITY_CHARGES", "discontinuation_notice": "Instead use one of DESTINATIONCHARGE or DESTINATIONTAX", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": true }, { "charge_type_id": "ENVIRONMENTFEE", "booking_extended_legacy_code": [ 5000 ], "charge_category": "LOCALITY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "SPATAX", "booking_extended_legacy_code": [ 5001 ], "charge_category": "LOCALITY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "HOTSPRINGTAX", "booking_extended_legacy_code": [ 5002 ], "charge_category": "LOCALITY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "MUNICIPALITYFEE", "booking_extended_legacy_code": [ 5003 ], "charge_category": "LOCALITY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "RESIDENTIALTAX", "booking_extended_legacy_code": [ 5004 ], "charge_category": "LOCALITY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "CITYTICKET", "booking_extended_legacy_code": [ 5005 ], "charge_category": "LOCALITY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "HERITAGECHARGE", "booking_extended_legacy_code": [ 5006 ], "charge_category": "LOCALITY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "FITNESSTAX", "booking_extended_legacy_code": [ 5007 ], "charge_category": "LOCALITY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "LOCALCOUNCILTAX", "booking_extended_legacy_code": [ 5008 ], "charge_category": "LOCALITY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "CLEANINGFEE", "booking_extended_legacy_code": [ 5009 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "TOWELFEE", "booking_extended_legacy_code": [ 5010 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "ELECTRICITYFEE", "booking_extended_legacy_code": [ 5011 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY", "INCALCULABLE" ], "discontinued": false }, { "charge_type_id": "BEDLINEN", "booking_extended_legacy_code": [ 5012 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "GASFEE", "booking_extended_legacy_code": [ 5013 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY", "INCALCULABLE" ], "discontinued": false }, { "charge_type_id": "OILFEE", "booking_extended_legacy_code": [ 5014 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY", "INCALCULABLE" ], "discontinued": false }, { "charge_type_id": "WOODFEE", "booking_extended_legacy_code": [ 5015 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY", "INCALCULABLE" ], "discontinued": false }, { "charge_type_id": "WATERFEE", "booking_extended_legacy_code": [ 5016 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY", "INCALCULABLE" ], "discontinued": false }, { "charge_type_id": "TRANSFERFEE", "booking_extended_legacy_code": [ 5017 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "LINENPACKAGEFEE", "booking_extended_legacy_code": [ 5018 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "HEATINGFEE", "booking_extended_legacy_code": [ 5019 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "AIRCONDITIONINGFEE", "booking_extended_legacy_code": [ 5020 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "KITCHENLINNENFEE", "booking_extended_legacy_code": [ 5021 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "HOUSEKEEPINGFEE", "booking_extended_legacy_code": [ 5022 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "AIRPORTSHUTTLEFEE", "booking_extended_legacy_code": [ 5023 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "SHUTTLEBOATFEE", "booking_extended_legacy_code": [ 5024 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "SEAPLANEFEE", "booking_extended_legacy_code": [ 5025 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "SKIPASS", "booking_extended_legacy_code": [ 5026 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "FINALCLEANINGFEE", "booking_extended_legacy_code": [ 5027 ], "charge_category": "PROPERTY_CHARGES", "discontinuation_notice": "Instead use CLEANINGFEE", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": true }, { "charge_type_id": "WRISTBANDFEE", "booking_extended_legacy_code": [ 5028 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "VISASUPPORTFEE", "booking_extended_legacy_code": [ 5029 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "WATERPARKFEE", "booking_extended_legacy_code": [ 5030 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "CLUBCARDFEE", "booking_extended_legacy_code": [ 5031 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "CONSERVATIONFEE", "booking_extended_legacy_code": [ 5032 ], "charge_category": "PROPERTY_CHARGES", "discontinuation_notice": "Instead use LOCALITYCONSERVATIONFEE", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": true }, { "charge_type_id": "CREDITCARDFEE", "booking_extended_legacy_code": [ 5033 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "PETFEE", "booking_extended_legacy_code": [ 5034 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "INTERNETFEE", "booking_extended_legacy_code": [ 5035 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "PARKINGFEE", "booking_extended_legacy_code": [ 5036 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "DESTINATIONCHARGE", "booking_extended_legacy_code": [ 5038 ], "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "DESTINATIONTAX", "booking_extended_legacy_code": [ 5039 ], "charge_category": "LOCALITY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "SERVICECHARGE_ASIA", "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "LAST_SERVICECHARGE", "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "GALADINNERFEE", "charge_category": "PROPERTY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "GOODSSERVICESFLOODTAX", "charge_category": "TAXES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "GOVERNMENTCHARGE", "charge_category": "TAXES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "DAMAGEDEPOSIT", "discontinuation_notice": "Instead use damage deposit product from value merchandising", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": true }, { "charge_type_id": "SUSTAINABILITYFEE", "charge_category": "LOCALITY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "LOCALITYCONSERVATIONFEE", "charge_category": "LOCALITY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "SPA", "charge_category": "FACILITY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "HOTSPRINGBATH", "charge_category": "FACILITY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "POOL", "charge_category": "FACILITY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false }, { "charge_type_id": "LOUNGE", "charge_category": "FACILITY_CHARGES", "allowed_charge_modes": [ "PERCENTAGE", "PER_NIGHT", "PER_STAY", "PER_PERSON_PER_NIGHT", "PER_PERSON_PER_STAY" ], "discontinued": false } ], "warnings": [], "errors": [], "meta": { "ruid": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" } }