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 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
Preview
This is not yet finalised. It may change, or be removed or be not yet accessible.
An endpoint to look for accommodation suggestions. It returns a list of suggestions, which is an excerpt of the actual accommodation data.
Preview
This is not yet finalised. It may change, or be removed or be not yet accessible.
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: v2" \-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 accommodation
Preview
This is not yet finalised. It may change, or be removed or be not yet accessible.
Gets a specific accommodation's details.
Preview
This is not yet finalised. It may change, or be removed or be not yet accessible.
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: v2" \-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"},"brand": {"name": "Duffel Test","id": "bra_0000Alr8BYNsbmDMThHSbI"},"amenities": [{"type": "parking","description": "Parking"}]}}