countrycurrencies (B.XML)

Use this endpoint to retrieve a list of country codes with their corresponding currency codes that are used on Booking.com. The country codes are based on a subset of ISO 3166-1 alpha-2 codes, and the currency codes are based on a subset of ISO 4217 Alphabetic codes. However, they do not always correspond exactly.

Note the following important facts regarding currency on Booking.com:

• While most currency codes do correspond with their ISO 4217's entity country, there are several notable exceptions where the country currency is not the currency in use on Booking.com.
• The Connectivity Partner cannot change currency. Currency is a Booking.com system setting based on the country where the accommodation was built.

Example:

<countrycurrency countrycode="mx" currencycode="USD"/>

This means that Mexico ('mx') is an exception where country currency of ISO 4217 is not in use on the Booking.com API. The United States Dollar (USD) is used for accommmodations in Mexico. Therefore, all prices need to be in United States Dollars. If the provider sends '1500' expecting currency MXN (Mexican pesos), the system will instead sell the room at 1500 USD. Any currency information sent by the provider will therefore not be processed.

The most current list as returned by this call should be considered the authoritative source of the currency code for the given country code for the API.

This topic also includes:

• List of supported currencies
• List of dual-currency countries

Step 1: Request for a list of country codes and currency codes

GET https://supply-xml.booking.com/hotels/xml/countrycurrencies

Response of country codes/names

<?xml version="1.0" encoding="UTF-8"?>
<countrycurrencies>
  <countrycurrency countrycode="ad" currencycode="EUR" />
  <countrycurrency countrycode="ae" currencycode="AED" />
  <countrycurrency countrycode="af" currencycode="AFN" />
  <!-- example output. Use the API for a complete updated list -->
</countrycurrencies>
<!-- RUID: [XXXXXXXXXXXXXXXXXXXXXXXXXXX==] -->

Response — Node Overview

• The response body consists of a countrycurrencies root element. This is the parent node to the countrycurrency node, whose multiplicity is determined by the number of countries available (240 at the time of writing).

• The empty child node countrycurrency contains the @countrycode and the @currencycode described below.

Response — Attribute(@) Overview

• The @countrycode of country contains the two lowercase letters of the ISO 3166-1 alpha-2 code of the country.

• The @currencycode of country contains the ISO 4217-based alphabetic codes of the corresponding @countrycode.

As with every standard Booking.com response, an RUID string terminates the message inside an XML comment node and should be stored by the Connectivity Partner for at least 30 days.

Errors/Warnings

No common, known errors exist with this call.

If an error/warning is encountered, and basic troubleshooting methods has been found ineffective, please provide the error/warning message along with the RUID of the response message to your Booking.com support contact.

List of supported currencies

The following table contains the currency code and currency name for all supported currencies.

Dual-Currency Countries

Properties located in the following countries have more than one allowed currency. You can use the OTA_HotelDescriptiveContentNotif or Property API to set a different currency for the property when the property status is XML: Being built or Test Hotel. Countries not in the list below support only one allowed currency and is assigned by default.

NOTE: The below values are accurate as of Dec 2024. Expanding the existing currency endpoint to include this information is being considered.