Last updated

countrycurrencies (B.XML)

This call is intended for the Connectivity Partner to be able to retrieve a list of country codes with their corresponding currency codes that are used on The country codes are based as 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. Please note the following important facts regarding currency on

  1. 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
  2. The Connectivity Partner cannot change currency. Currency is a system setting based on the country where the accommodation was built.


<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 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.

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


Response of country codes/names

<?xml version="1.0" encoding="UTF-8"?>
  <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 -->

Response — Node Overview

Node NameNest LevelParent NodeValue RangeData TypeNode Multiplicity
countrycurrencyL1countrycurrencies----[see below]
  • 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

Attribute NameNode NameValue RangeData TypeNode Multiplicity
  • 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 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.


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 support contact.