Accommodation
An accommodation recorded by Duffel
Schema
The amenities for this accommodation. This can be null when we are unable to retrieve amenity data. Accommodation amenities aid guests in identifying the accommodation that suits their needs. These are intended for programmatic use to support filtering or promoting specific accommodation attributes.
The currency for cheapest_rate_total_amount
for this accommodation, as an ISO 4217 currency code.
This information isn't available when getting an accommodation by ID.
This is deprecated — use cheapest_rate_currency
instead which is never null.
"GBP"
The cheapest_rate_total_amount
is for search result display purposes. It is equivalent to the cheapest rate total_amount for the cheapest room at this accommodation.
The rate amount is a best effort computation during the time a search is made, and can change when fetching the rates. It is not guaranteed to be accurate. It will always show a value, even when rooms data is empty in the initial Search response.
This information isn't available when getting an accommodation by ID.
Deprecated, see cheapest_rate_total_amount
.
"799.00"
The accommodation email address. This field can only be populated on the accommodation for a completed booking. Note that this data may differ from the accommodation records if it was updated directly by the accommodation after the booking was created.
"reservations@duffel-hotel-group.com"
The accommodation phone number. This field can only be populated on the accommodation for a completed booking. This is provided directly by the accommodation and the format is not guaranteed. Note that this data may differ from the accommodation records if it was updated directly by the accommodation after the booking was created."
"+442074938181"
Ratings given to an accommodation by a rating source.
This can be empty if the accommodation does not have any ratings. This can also be null if we are unable to retrieve ratings.
These are commonly represented as "stars". In Duffel Stays, they have a 1-5 scale.
They can come from multiple sources. Currently available rating sources are:
"priceline"
: Priceline.com star rating.
These should be displayed as "stars". While Priceline.com can add half a star to a rating, these ratings are rounded down to the nearest full star in Duffel Stays.
"bookingcom"
: Booking.com star rating.
These should be displayed as "stars". While Booking.com can add half a star to a rating, these ratings are rounded down to the nearest full star in Duffel Stays.
"expedia"
: Expedia star rating.
These should be displayed as "stars". While Expedia can add half a star to a rating, these ratings are rounded down to the nearest full star in Duffel Stays.
These should be displayed as "diamonds".
"northstar"
: Northstar Travel Media Hotel Crown Rating.
These should be displayed as "crowns".
The loyalty programme that is supported by the accommodation.
"wyndham_rewards"
, "choice_privileges"
, "marriott_bonvoy"
, "best_western_rewards"
, "world_of_hyatt"
, "hilton_honors"
, "ihg_one_rewards"
, "leaders_club"
, "stash_rewards"
, "omni_select_guest"
, "i_prefer"
, "accor_live_limitless"
, "my_6"
, "jumeirah_one"
, "global_hotel_alliance_discovery"
, or "duffel_hotel_group_rewards"
Search for accommodation suggestions
An endpoint to look for accommodation suggestions. It returns a list of suggestions, which is an excerpt of the actual accommodation data.
POST https://api.duffel.com/stays/accommodation/suggestions
curl -X POST --compressed "https://api.duffel.com/stays/accommodation/suggestions" \-H "Accept-Encoding: gzip" \-H "Accept: application/json" \-H "Content-Type: application/json" \-H "Duffel-Version: v1" \-H "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \-d '{"data": {"query": "rits","location": {"radius": 5,"geographic_coordinates": {"longitude": -0.1416,"latitude": 51.5071}}}}'
{"data": [{"accommodation_name": "Duffel Test Hotel","accommodation_location": {"geographic_coordinates": {"longitude": -0.1416,"latitude": 51.5071},"address": {"region": "England","postal_code": "EC2A 4TP","line_one": "100 Clifton Street","country_code": "GB","city_name": "London"}},"accommodation_id": "acc_0000AWr2VsUNIF1Vl91xg0"}]}
GET https://api.duffel.com/stays/accommodation/{id}
curl -X GET --compressed "https://api.duffel.com/stays/accommodation/{id}" \-H "Accept-Encoding: gzip" \-H "Accept: application/json" \-H "Content-Type: application/json" \-H "Duffel-Version: v1" \-H "Authorization: Bearer <YOUR_ACCESS_TOKEN>"
{"data": {"supported_loyalty_programme": "duffel_hotel_group_rewards","rooms": [],"review_score": 8.8,"rating": 3,"photos": [{"url": "https://assets.duffel.com/img/stays/image.jpg"}],"phone_number": "+442074938181","name": "Duffel Test Hotel","location": {"geographic_coordinates": {"longitude": -0.1416,"latitude": 51.5071},"address": {"region": "England","postal_code": "EC2A 4TP","line_one": "100 Clifton Street","country_code": "GB","city_name": "London"}},"key_collection": {"instructions": "Please collect the keys from accommodation's reception."},"id": "acc_0000AWr2VsUNIF1Vl91xg0","email": "reservations@duffel-hotel-group.com","description": "Ornate quarters, some with grand pianos, in a luxurious hotel offering acclaimed dining & a spa.","check_in_information": {"check_out_before_time": "11:30","check_in_after_time": "14:30"},"chain": {"name": "Duffel Hotel Group"},"amenities": [{"type": "parking","description": "Parking"}]}}