Skip to main content

Currency Code

Currency Code

Rates can be set up in the Hotel’s default currency or alternate currencies if enabled. By default, the response only includes rates configured in the default currency. To request rates in an alternate currency in addition to rates loaded in the default currency use @currencyCode.

Note: Only rates set up in the requested currency are returned. Currency conversion of the rate amount is not supported.

ParameterDescriptionType
currencyCodeISO-4217 - This is a three-letter currency code used to request the alternate currency that rates should include in addition to rates set up in the hotel’s default currency. 
No currency conversion is performed.
String

Sample Request

The hotel has a default currency of USD. Include currencyCode=EUR to return rates that are configured in either USD or EUR.

/v1/api/hotel/availability?hotelId=13098&chainId=12723&adults=2&startDate=2022-12-17&endDate=2022-12-20&numRooms=1&primaryChannel=WEB&secondaryChannel=WEB&adults=2&currencyCode=EUR

Response (partial)

{
    "productAvailability": {
        "Prices": [{
            "Product": {
                "Prices": {
                    "Daily": [],
                    "PerNight": {},
                    "Total": {
                        "Price": {
                            "Fees": {},
                            "Tax": {},
                            "Total": {
                                "Amount": 80,
                                "AmountWithTaxesFees": 100,
                                "AmountWithInclusiveTaxes": 100
                            },
                            "Amount": 80,
                            "CurrencyCode": "USD"
                        }
                    }
                },
                "Rate": {
                    "Code": "BAR"
                },
                "Room": {
                    "Code": "SUPK"
                }
            }
        }, {
            "Product": {
                "Prices": {
                    "Daily": [],
                    "PerNight": {},
                    "Total": {
                        "Price": {
                            "Fees": {},
                            "Tax": {},
                            "Total": {
                                "Amount": 79,
                                "AmountWithTaxesFees": 99,
                                "AmountWithInclusiveTaxes": 99
                            },
                            "Amount": 79,
                            "CurrencyCode": "EUR"
                        }
                    }
                },
                "Rate": {
                    "Code": "ELB"
                },
                "Room": {
                    "Code": "SUPK"
                }
            }
        }]
    }
}