Hotel Property Code Search

GET

Hotel Property Code Search

This API allows you to quickly see the detailed information of a single hotel, including descriptions, address, GPS location, amenities, awards, lowest priced room and all room prices and booking information.

This API gives you more information on a specific property. Optional parameters such as show_sold_out & rooms can be used to show sold out rooms and all available rooms.

The API is based on our high-speed hotel pricing cache, which is also used to power the Amadeus Hotel Search Engine application. Results are returned very quickly, response times are generally under 2s. Our cache has great global coverage and is constantly refreshed with the latest prices.

Resource URL

https://api.sandbox.amadeus.com/v1.2 /hotels/{property_code}

Query Parameters


Name Values Description
apikey
(required)

API Key provided for your account, to identify you for API access. Make sure to keep this API key secret.

check_in
(required)

Date on which the guest will begin their stay in the hotel. Past availability is not displayed, future availability becomes less useful from about 6 months from the current date.

check_out
(required)

Date on which the guest will end their stay in the hotel.

lang

The preferred language of the content related to each hotel. Content will be returned in this language if available.

currency

The preferred currency for the results

all_rooms

This option if enabled will return all hotel room rates, not just the lowest room rate. Note: This will have an impact on the response time due to the larger messages returned.

show_sold_out

This option if enabled will return hotel names and addresses even if rooms are sold out (closed properties)


Request Body

property_code A Hotel property code based on 2 letter chain code + 3 letter <a href="https://en.wikipedia.org/wiki/International_Air_Transport_Association_airport_code">IATA code</a> of the city + 3 char property unique id. BWDCA133 true

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Working...

 

Response format - Hotel Property Code Search

The response is returned in JSON with the following elements:

Element Meaning Multiplicity
Root object
results The array of search result objects, sorted by price. The length of the array will correspond to the number_of_results parameter used in the input. 1..99
Result object
property_code The 8 character property code of this given hotel. The first 2 characters of this code are the chain code that can be specified in the input. The remaining elements are proprietary to each hotel chain. 1
property_name The name of this hotel. 1
location This hotel's approximate geolocation as a location object. 1
address This hotel's postal address as an address object. 0..1
total_price The lowest price of a stay, from the given check in date to the given check out date. 1
min_daily_rate The lowest price per day that the hotel offers between the given check-in and check-out dates. Extra taxes may apply to this rate. 1
contacts An array of contact objects to tell the user how to contact the hotel. Typically includes a phone and fax number. 0..n
amenities An array of amenity objects to the user what facilities this hotel might provide, such as a pool or parking. If this array is empty, it does not necessarily mean that there are no amenities available at this hotel, it could also mean that the hotel does not list their amenities in our search! 0..n
awards An array of hotel award objects to give the user an expectation of the service quality at this hotel. This can be used to indicate, for example, the star rating of a hotel. If this array is empty, it does not necessarily mean that the hotel has no awards, it could simply mean that they didn't tell us about them! 0..n
images A selection of image objects, showing pictures of the hotel building, the entrance or some rooms, to give an indication of what to expect at this hotel. Note that redistribution of images outside Amadeus products requires licensing from our image providers: Leonardo and Ice Portal. Thus image links from this API are returned for whitelisted Amadeus users only. 0..n
Location object
latitude The north-south location of this hotel, in decimal degrees, between -90 and 90. 1
longitude The east-west location of this hotel, in decimal degrees, between -180 and 180. 1
Address object
line1 The first line of the hotel's address. Generally represents the hotel's basic street address. 1
city The town or city in which hotel is located. 1
region The state or region code in which the hotel is located. 0..1
postal_code The postal or zip code of this address. 0..1
country The ISO 3166-1 alpha-2 country code of this address. 0..1
Amenities object
amenity The amenity code 0..1
ota_code The Open Travel Alliance Hotel Amenities Code for this amenity. 0..1
description The decoded text description for this amenity code, where available. 0..1
Award object
provider The organization that issued the award. For example:. Local Star Rating, AAA. 0..1
rating The level of the award that was awarded on the provider's scale. For example: 4 or RECOMMENDED. 0..1
Image object
category The enumerated category of this image type. Common values include EXTERIOR, GUEST_ROOM, SUITE, LOBBY, RESTAURANT, LOUNGE, LOGO, MAP, MISC and UNKNOWN. 0..1
width The pixel width of the image at the provided URL. 0..1
height The pixel height of the image at the provided URL. 0..1
url The URL of the hotel image of this given category and size, for display. 0..1
Rooms object
booking_code The booking code identifies a product at the hotel. It can be used to book a room. 0..1
room_type_code A 3-letter code to identify a specific room type. The letters may be representative, for example A1Q: A=Superior, 1=1 bed, Q=Queen size. 1
rate_plan_code A 3 letter code to designate different rates base on traveler type. 1
Total amount object
amount Total amount for the stay period. For example: $194.99. 1
currency Currency code of the total amount. For example: "USD". 1
rates object An array of room rate objects including start_date, end_date, currency_code and price for the given stay period. If room rates are different during the stay period, multiple rate objects are displayed with various rates corresponding to their dates. 1..n
descriptions An array of description objects describing room and rate types features. 0..n
 

Example - Hotel Property Code Search

Here a simple hotel property code search examples. Just copy the following URLs in your web browser. Don't forget to adjust the check-in and check-out dates as necessary, and use your own API key.

Hotel Property Code Search

Find hotel with property code of RTNCEPUL

Request

https://api.sandbox.amadeus.com/v1.2/hotels/RTNCEPUL?check_in=2015-08-03&check_out=2015-08-04&apikey=<YOUR API KEY HERE>

Response

{
  "property_code" : "RTNCEPUL",
  "property_name" : "Mercure Nice Ctr Notre Dame 4*",
  "location" : {
    "latitude" : 43.70353,
    "longitude" : 7.26646
  },
  "address" : {
    "line1" : "28 Avenue Notre Dame",
    "city" : "Nice",
    "postal_code" : "06000",
    "country" : "FR"
  },
  "total_price" : {
    "amount" : "112.87",
    "currency" : "USD"
  },
  "min_daily_rate" : {
    "amount" : "112.87",
    "currency" : "USD"
  },
  "contacts" : [ {
    "type" : "PHONE",
    "detail" : "33/4/93133636"
  }, {
    "type" : "FAX",
    "detail" : "33/4/93626169"
  } ],
  "amenities" : [ {
    "amenity" : "ELEVATORS",
    "ota_code" : 33,
    "description" : "Elevators"
  }, {
    "amenity" : "SAFE_DEPOSIT_BOX",
    "ota_code" : 78,
    "description" : "Safe deposit box"
  }, {
    "amenity" : "ROOM_SERVICE",
    "ota_code" : 77,
    "description" : "Room service"
  }, {
    "amenity" : "AC_220V",
    "ota_code" : 115,
    "description" : "220 AC"
  }, {
    "amenity" : "",
    "ota_code" : 56,
    "description" : "Jogging track"
  }, {
    "amenity" : "",
    "ota_code" : 179,
    "description" : "Wireless internet connection in public areas"
  }, {
    "amenity" : "CHILDREN_WELCOME",
    "ota_code" : 218,
    "description" : "Children welcome"
  }, {
    "amenity" : "",
    "ota_code" : 106,
    "description" : "Bell staff/porter"
  }, {
    "amenity" : "SOLARIUM",
    "ota_code" : 83,
    "description" : "Solarium"
  }, {
    "amenity" : "MULTILINGUAL_STAFF",
    "ota_code" : 103,
    "description" : "Multilingual staff"
  }, {
    "amenity" : "MASSAGE_SERVICES",
    "ota_code" : 61,
    "description" : "Massage services"
  }, {
    "amenity" : "OUTDOOR_POOL",
    "ota_code" : 66,
    "description" : "Outdoor pool"
  }, {
    "amenity" : "INTERNET_SERVICES",
    "ota_code" : 223,
    "description" : "Internet services"
  }, {
    "amenity" : "PARKING",
    "ota_code" : 68,
    "description" : "Parking"
  }, {
    "amenity" : "PETS_ALLOWED",
    "ota_code" : 224,
    "description" : "Pets allowed"
  }, {
    "amenity" : "",
    "ota_code" : 91,
    "description" : "Tour/sightseeing desk"
  }, {
    "amenity" : "CONCIERGE_DESK",
    "ota_code" : 22,
    "description" : "Concierge desk"
  }, {
    "amenity" : "CURRENCY_EXCHANGE",
    "ota_code" : 26,
    "description" : "Currency exchange"
  }, {
    "amenity" : "LOUNGE_BARS",
    "ota_code" : 165,
    "description" : "Lounges/bars"
  }, {
    "amenity" : "DOCTOR_ON_CALL",
    "ota_code" : 28,
    "description" : "Doctor on call"
  }, {
    "amenity" : "FRONT_DESK_24_HOURS",
    "ota_code" : 1,
    "description" : "24-hour front desk"
  }, {
    "amenity" : "",
    "ota_code" : 53,
    "description" : "Indoor parking"
  }, {
    "amenity" : "BABY_SITTING",
    "ota_code" : 8,
    "description" : "Baby sitting"
  }, {
    "amenity" : "RESTAURANT",
    "ota_code" : 76,
    "description" : "Restaurant"
  } ],
  "awards" : [ {
    "provider" : "Local Star Rating",
    "rating" : "4"
  }, {
    "provider" : "Michelin",
    "rating" : "4"
  }, {
    "provider" : "OHG",
    "rating" : "F Star"
  } ],
  "images" : [ ],
  "rooms" : [ {
    "booking_code" : "C2TRA1",
    "room_type_code" : "C2T",
    "rate_plan_code" : "RA1",
    "total_amount" : {
      "amount" : "161.25",
      "currency" : "USD"
    },
    "rates" : [ {
      "start_date" : "2015-08-03",
      "end_date" : "2015-08-04",
      "currency_code" : "USD",
      "price" : 161.25
    } ],
    "descriptions" : [ "Best Unrestricted Rate", "Standard Room with two single beds" ]
  }, {
    "booking_code" : "D1DRA1",
    "room_type_code" : "D1D",
    "rate_plan_code" : "RA1",
    "total_amount" : {
      "amount" : "161.25",
      "currency" : "USD"
    },
    "rates" : [ {
      "start_date" : "2015-08-03",
      "end_date" : "2015-08-04",
      "currency_code" : "USD",
      "price" : 161.25
    } ],
    "descriptions" : [ "Best Unrestricted Rate", "Standard Room with double bed and garden view" ]
  }, {
    "booking_code" : "A1DRA1",
    "room_type_code" : "A1D",
    "rate_plan_code" : "RA1",
    "total_amount" : {
      "amount" : "204.54",
      "currency" : "USD"
    },
    "rates" : [ {
      "start_date" : "2015-08-03",
      "end_date" : "2015-08-04",
      "currency_code" : "USD",
      "price" : 204.54
    } ],
    "descriptions" : [ "Best Unrestricted Rate", "Privilege Room with queen-size bed" ]
  }, {
    "booking_code" : "A1KRA1",
    "room_type_code" : "A1K",
    "rate_plan_code" : "RA1",
    "total_amount" : {
      "amount" : "258.65",
      "currency" : "USD"
    },
    "rates" : [ {
      "start_date" : "2015-08-03",
      "end_date" : "2015-08-04",
      "currency_code" : "USD",
      "price" : 258.65
    } ],
    "descriptions" : [ "Best Unrestricted Rate", "Junior Privilege Suite with king-size bed and v", "iews of the Notre Dame Basilica" ]
  }, {
    "booking_code" : "C2TEAM",
    "room_type_code" : "C2T",
    "rate_plan_code" : "EAM",
    "total_amount" : {
      "amount" : "112.87",
      "currency" : "USD"
    },
    "rates" : [ {
      "start_date" : "2015-08-03",
      "end_date" : "2015-08-04",
      "currency_code" : "USD",
      "price" : 112.87
    } ],
    "descriptions" : [ "Mercure Breaks-Early / RO", "Standard Room with two single beds" ]
  }, {
    "booking_code" : "C2TSEN",
    "room_type_code" : "C2T",
    "rate_plan_code" : "SEN",
    "total_amount" : {
      "amount" : "161.25",
      "currency" : "USD"
    },
    "rates" : [ {
      "start_date" : "2015-08-03",
      "end_date" : "2015-08-04",
      "currency_code" : "USD",
      "price" : 161.25
    } ],
    "descriptions" : [ "Senior Rate - Age 60 and over-BB/Bed+Brkfast", "Standard Room with two single beds" ]
  }, {
    "booking_code" : "D1DEAM",
    "room_type_code" : "D1D",
    "rate_plan_code" : "EAM",
    "total_amount" : {
      "amount" : "112.87",
      "currency" : "USD"
    },
    "rates" : [ {
      "start_date" : "2015-08-03",
      "end_date" : "2015-08-04",
      "currency_code" : "USD",
      "price" : 112.87
    } ],
    "descriptions" : [ "Mercure Breaks-Early / RO", "Standard Room with double bed and garden view" ]
  }, {
    "booking_code" : "D1DSEN",
    "room_type_code" : "D1D",
    "rate_plan_code" : "SEN",
    "total_amount" : {
      "amount" : "161.25",
      "currency" : "USD"
    },
    "rates" : [ {
      "start_date" : "2015-08-03",
      "end_date" : "2015-08-04",
      "currency_code" : "USD",
      "price" : 161.25
    } ],
    "descriptions" : [ "Senior Rate - Age 60 and over-BB/Bed+Brkfast", "Standard Room with double bed and garden view" ]
  }, {
    "booking_code" : "A1DEAM",
    "room_type_code" : "A1D",
    "rate_plan_code" : "EAM",
    "total_amount" : {
      "amount" : "143.18",
      "currency" : "USD"
    },
    "rates" : [ {
      "start_date" : "2015-08-03",
      "end_date" : "2015-08-04",
      "currency_code" : "USD",
      "price" : 143.18
    } ],
    "descriptions" : [ "Mercure Breaks-Early / RO", "Privilege Room with queen-size bed" ]
  }, {
    "booking_code" : "A1DSEN",
    "room_type_code" : "A1D",
    "rate_plan_code" : "SEN",
    "total_amount" : {
      "amount" : "204.54",
      "currency" : "USD"
    },
    "rates" : [ {
      "start_date" : "2015-08-03",
      "end_date" : "2015-08-04",
      "currency_code" : "USD",
      "price" : 204.54
    } ],
    "descriptions" : [ "Senior Rate - Age 60 and over-BB/Bed+Brkfast", "Privilege Room with queen-size bed" ]
  }, {
    "booking_code" : "A1KEAM",
    "room_type_code" : "A1K",
    "rate_plan_code" : "EAM",
    "total_amount" : {
      "amount" : "181.05",
      "currency" : "USD"
    },
    "rates" : [ {
      "start_date" : "2015-08-03",
      "end_date" : "2015-08-04",
      "currency_code" : "USD",
      "price" : 181.05
    } ],
    "descriptions" : [ "Mercure Breaks-Early / RO", "Junior Privilege Suite with king-size bed and v", "iews of the Notre Dame Basilica" ]
  }, {
    "booking_code" : "A1KSEN",
    "room_type_code" : "A1K",
    "rate_plan_code" : "SEN",
    "total_amount" : {
      "amount" : "258.65",
      "currency" : "USD"
    },
    "rates" : [ {
      "start_date" : "2015-08-03",
      "end_date" : "2015-08-04",
      "currency_code" : "USD",
      "price" : 258.65
    } ],
    "descriptions" : [ "Senior Rate - Age 60 and over-BB/Bed+Brkfast", "Junior Privilege Suite with king-size bed and v", "iews of the Notre Dame Basilica" ]
  } ]
}

Error Example

A request with a check-in date after the check-out date.

http://api.sandbox.amadeus.com/v1.2/hotels/ABCDEF132?check_in=2015-07-28&check_out=2015-07-02&apikey=<your API key>

Response

{
  "status" : 400,
  "message" : "2015-07-28/2015-07-02 is not a valid check_in/check_out. Expected the check-in date to be before the check-out date"
}

 

OTA Hotel Amenity Code Table

This is the OTA Hotel Amenity Code Table used to supply amenity information. The 2014A code table is used by the API. To stay up to date, sign up to receive the official code table from the Open Travel Alliance.