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/metaTo 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"
}
}