Hotel Search API

Parameter

Type

Category

Description

ACCESS_TOKEN

string

required

Our unique access token

hotelIds

array[string]

required

The 8-character Amadeus property code for hotels

Note: Refer to the appendix for the hotel IDs.

adults

integer

required

The number of adult guests per room; its range of values is from 1 to 9

checkInDate

string

optional

The check-in date of the traveler; its default value is the current date in the GMT time zone

Note: No dates from the past are allowed.

Format: YYYY-MM-DD

checkOutDate

string

optional

The check-out date of the traveler; its lowest value and default value is checkInDate + 1

Format: YYYY-MM-DD

countryOfResidence

string

optional

A 2-character code for the traveler's country of residence

Note: Refer to the appendix for the country codes.

roomQuantity

integer

optional

The number of requested rooms; its range of values is 1 to 9, its default value is 1

priceRange

string

optional

Filters hotel offers by price per night interval

Note: It’s mandatory to set currency when this field is set.

currency

string

optional

A 3-character code of the requested currency for the results. If a hotel does not support the requested currency, the prices for the hotel will be returned in the local currency of the hotel.

Note: Refer to the appendix for the currency codes.

paymentPolicy

string

optional

Filters the response based on a specific payment type; its possible values are GUARANTEE, DEPOSIT, and NONE; its default value is NONE

boardType

string

optional

Filters the response based on available meals; its possible values are ROOM_ONLY, BREAKFAST, HALF_BOARD (Dinner & Breakfast–only for Aggregators), FULL_BOARD (Full Board–only for Aggregators), and ALL_INCLUSIVE (All Inclusive–only for Aggregators)

includeClosed

boolean

optional

This is true for all properties including those sold out. It's false only for available ones. For sold-out properties, you may check availability on other dates.

bestRateOnly

boolean

optional

This is true for the cheapest offer per hotel and false for all available offers. Its default value is true.

lang

string

optional

A 2-character code of the requested language for the results. If a language is not available, the response will be returned in English.

Note: Refer to the appendix for the language codes.