currencies (B.XML)

This call is intended for the Connectivity Partner to be able to retrieve a list of currency codes with their corresponding currency name that are used on Booking.com. The currency information is based on a subset of ISO 4217 Alphabetic codes and currency names but altered in some cases. The most current list as returned by this call should therefore be considered the authoritative source of currency codes and names for the API.

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

POST https://supply-xml.booking.com/hotels/xml/currencies

Request — HTTP Message Body Model

<?xml version="1.0" encoding="UTF-8"?>
<request>
  <username>providermachinelogin</username>
  <password>********</password>
</request>

Request — Node Overview

Node Name Nest Level Parent Node Value Range Data Type Node Multiplicity
password L1 request -- string 1
request L0 NULL(root) -- -- 1
username L1 request -- string 1

Request — cURL Model

curl -H "Host: providerhostname" \
-H "Connection: keep-alive" \
-H "Content-Length: XXX" \
-H "Cache-Control: no-cache" \
-H "Origin: XXXXXXXXXXXXX" \
-H "User-Agent: Provider User-Agent name" \
-H "Content-Type: text/xml;charset=UTF-8" \
-H "Accept: */*" \
-H "Accept-Encoding: gzip,deflate" \
--http1.1 \
-d @messagebody.xml -X POST \
'https://supply-xml.booking.com/hotels/xml/currencies'

Step 2: Response of currency codes/names

Type HTTP Method Message Sender Message Receiver
Response POST Booking.com Connectivity Partner

Response — HTTP Message Body Sample

<?xml version="1.0" encoding="UTF-8"?>
<currencies>
   <currency currencycode="EUR" name="Euro" />
   <currency currencycode="USD" name="U.S. dollar" />
   <currency currencycode="BHD" name="Bahrain dinar" />
   <currency currencycode="BWP" name="Botswana pula" />
   <!-- example output. Use the API for a complete updated list -->
</currencies>
<!-- RUID: [XXXXXXXXXXXXXXXXXXXXXXXXXXX==] -->