Bookings
A reservation with the stay for the room(s) requested from a quote
Schema
The ISO 8601 datetime of the cancellation of this booking. This is null
if the booking is not yet cancelled.
null
The key collection details for the booking. This field is deprecated and will be removed in a future version. Please use Accommodation.check_in_information.key_collection instead.
The loyalty programme account number provided for the Booking when the create Booking endpoint was called.
Account number is relayed to the hotel on a best-effort basis, it is at the hotel's discretion to honour the loyalty programme.
"201154908"
The loyalty programme that this booking supports.
"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"
List bookings
Lists all the bookings made for your organisation. Returns a list of Duffel Stay Bookings.
GET https://api.duffel.com/stays/bookings
curl -X GET --compressed "https://api.duffel.com/stays/bookings" \-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","status": "confirmed","rooms": 1,"reference": "AFE33SE2","loyalty_programme_account_number": "201154908","id": "bok_0000BTVRuKZTavzrZDJ4cb","guests": [{"given_name": "Amelia","family_name": "Earhart"}],"confirmed_at": "2023-04-13T15:48:11.642Z","check_out_date": "2023-05-28","check_in_date": "2023-05-24","accommodation": {"rooms": [{"rates": [{"total_currency": "GBP","total_amount": "799.00","tax_currency": "GBP","tax_amount": "82.23","supported_loyalty_programme": "duffel_hotel_group_rewards","quantity_available": 12,"payment_type": "pay_now","id": "rat_0000BTVRuKZTavzrZDJ4cb","fee_currency": "GBP","fee_amount": "50.94","due_at_accommodation_currency": "GBP","due_at_accommodation_amount": "39.95","conditions": [{"title": "Parking","description": "Public parking is available nearby for £15 per day"}],"cancellation_timeline": [{"refund_amount": "799.00","currency": "GBP","before": "2023-05-23T13:00:00Z"}],"board_type": "room_only","base_currency": "GBP","base_amount": "665.83","available_payment_methods": [["balance","card"]]}],"photos": [{"url": "https://assets.duffel.com/img/stays/image.jpg"}],"name": "Double Suite","beds": [{"type": "king","count": 2}]}],"review_score": 8.8,"rating": 3,"photos": [{"url": "https://assets.duffel.com/img/stays/image.jpg"}],"phone_number": "+442074938181","name": "The Ritz London","location": {"geographic_coordinates": {"longitude": -0.1416,"latitude": 51.5071},"address": {"region": "England","postal_code": "W1J 9BR","line_one": "150 Piccadilly","country_code": "GB","city_name": "London"}},"key_collection": {"instructions": "Please collect the keys from accommodation's reception."},"id": "acc_0000AWr2IgADo2rTllJJhI","email": "reservations@theritzlondon.com","description": "Ornate quarters, some with grand pianos, in a luxurious hotel offering acclaimed dining & a spa.","created_at": "2022-12-20T15:21:01Z","check_in_information": {"check_out_before_time": "11:30","check_in_after_time": "14:30"},"cheapest_rate_total_amount": "799.00","cheapest_rate_currency": "GBP","chain": {"name": "The Ritz-Carlton"},"amenities": [{"type": "parking","description": "Parking"}]}}]}
Creating a booking
To create a stay booking, select a quote and provide guest information. The booking can be paid using the Duffel balance. This action will return a Duffel Stays Booking, which will have a confirmed booking status.
If an unexpected error occurs, such as a 500 HTTP status code, and the booking status cannot be determined, do not attempt to retry the action. Instead, please contact Duffel Support for assistance with your request ID. Please see the Booking creation response handling documentation for more information on possible responses and how to handle them.
Body parameters
Loyalty programme account number to associate with this booking.
Use this only when the quote has a supported_loyalty_programme indicated. Otherwise, this will result into an error.
Account number is relayed to the hotel on a best-effort basis, it is at the hotel's discretion to honour the loyalty programme.
"201154908"
POST https://api.duffel.com/stays/bookings
curl -X POST --compressed "https://api.duffel.com/stays/bookings" \-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": {"users": ["icu_00009htyDGjIfajdNBZRlw"],"quote_id": "quo_0000AS0NZdKjjnnHZmSUbI","phone_number": "+442080160509","loyalty_programme_account_number": "201154908","guests": [{"user_id": "icu_00009htyDGjIfajdNBZRlw","given_name": "Amelia","family_name": "Earheart"}],"email": "amelia.earheart@duffel.com","accommodation_special_requests": "2:00 PM early check-in required"}}'
{"data": {"supported_loyalty_programme": "duffel_hotel_group_rewards","status": "confirmed","rooms": 1,"reference": "AFE33SE2","loyalty_programme_account_number": "201154908","id": "bok_0000BTVRuKZTavzrZDJ4cb","guests": [{"given_name": "Amelia","family_name": "Earhart"}],"confirmed_at": "2023-04-13T15:48:11.642Z","check_out_date": "2023-05-28","check_in_date": "2023-05-24","accommodation": {"rooms": [{"rates": [{"total_currency": "GBP","total_amount": "799.00","tax_currency": "GBP","tax_amount": "82.23","supported_loyalty_programme": "duffel_hotel_group_rewards","quantity_available": 12,"payment_type": "pay_now","id": "rat_0000BTVRuKZTavzrZDJ4cb","fee_currency": "GBP","fee_amount": "50.94","due_at_accommodation_currency": "GBP","due_at_accommodation_amount": "39.95","conditions": [{"title": "Parking","description": "Public parking is available nearby for £15 per day"}],"cancellation_timeline": [{"refund_amount": "799.00","currency": "GBP","before": "2023-05-23T13:00:00Z"}],"board_type": "room_only","base_currency": "GBP","base_amount": "665.83","available_payment_methods": [["balance","card"]]}],"photos": [{"url": "https://assets.duffel.com/img/stays/image.jpg"}],"name": "Double Suite","beds": [{"type": "king","count": 2}]}],"review_score": 8.8,"rating": 3,"photos": [{"url": "https://assets.duffel.com/img/stays/image.jpg"}],"phone_number": "+442074938181","name": "The Ritz London","location": {"geographic_coordinates": {"longitude": -0.1416,"latitude": 51.5071},"address": {"region": "England","postal_code": "W1J 9BR","line_one": "150 Piccadilly","country_code": "GB","city_name": "London"}},"key_collection": {"instructions": "Please collect the keys from accommodation's reception."},"id": "acc_0000AWr2IgADo2rTllJJhI","email": "reservations@theritzlondon.com","description": "Ornate quarters, some with grand pianos, in a luxurious hotel offering acclaimed dining & a spa.","created_at": "2022-12-20T15:21:01Z","check_in_information": {"check_out_before_time": "11:30","check_in_after_time": "14:30"},"cheapest_rate_total_amount": "799.00","cheapest_rate_currency": "GBP","chain": {"name": "The Ritz-Carlton"},"amenities": [{"type": "parking","description": "Parking"}]}}}
GET https://api.duffel.com/stays/bookings/{id}
curl -X GET --compressed "https://api.duffel.com/stays/bookings/{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","status": "confirmed","rooms": 1,"reference": "AFE33SE2","loyalty_programme_account_number": "201154908","id": "bok_0000BTVRuKZTavzrZDJ4cb","guests": [{"given_name": "Amelia","family_name": "Earhart"}],"confirmed_at": "2023-04-13T15:48:11.642Z","check_out_date": "2023-05-28","check_in_date": "2023-05-24","accommodation": {"rooms": [{"rates": [{"total_currency": "GBP","total_amount": "799.00","tax_currency": "GBP","tax_amount": "82.23","supported_loyalty_programme": "duffel_hotel_group_rewards","quantity_available": 12,"payment_type": "pay_now","id": "rat_0000BTVRuKZTavzrZDJ4cb","fee_currency": "GBP","fee_amount": "50.94","due_at_accommodation_currency": "GBP","due_at_accommodation_amount": "39.95","conditions": [{"title": "Parking","description": "Public parking is available nearby for £15 per day"}],"cancellation_timeline": [{"refund_amount": "799.00","currency": "GBP","before": "2023-05-23T13:00:00Z"}],"board_type": "room_only","base_currency": "GBP","base_amount": "665.83","available_payment_methods": [["balance","card"]]}],"photos": [{"url": "https://assets.duffel.com/img/stays/image.jpg"}],"name": "Double Suite","beds": [{"type": "king","count": 2}]}],"review_score": 8.8,"rating": 3,"photos": [{"url": "https://assets.duffel.com/img/stays/image.jpg"}],"phone_number": "+442074938181","name": "The Ritz London","location": {"geographic_coordinates": {"longitude": -0.1416,"latitude": 51.5071},"address": {"region": "England","postal_code": "W1J 9BR","line_one": "150 Piccadilly","country_code": "GB","city_name": "London"}},"key_collection": {"instructions": "Please collect the keys from accommodation's reception."},"id": "acc_0000AWr2IgADo2rTllJJhI","email": "reservations@theritzlondon.com","description": "Ornate quarters, some with grand pianos, in a luxurious hotel offering acclaimed dining & a spa.","created_at": "2022-12-20T15:21:01Z","check_in_information": {"check_out_before_time": "11:30","check_in_after_time": "14:30"},"cheapest_rate_total_amount": "799.00","cheapest_rate_currency": "GBP","chain": {"name": "The Ritz-Carlton"},"amenities": [{"type": "parking","description": "Parking"}]}}}
POST https://api.duffel.com/stays/bookings/{booking_id}/actions/cancel
curl -X POST --compressed "https://api.duffel.com/stays/bookings/{booking_id}/actions/cancel" \-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","status": "confirmed","rooms": 1,"reference": "AFE33SE2","loyalty_programme_account_number": "201154908","id": "bok_0000BTVRuKZTavzrZDJ4cb","guests": [{"given_name": "Amelia","family_name": "Earhart"}],"confirmed_at": "2023-04-13T15:48:11.642Z","check_out_date": "2023-05-28","check_in_date": "2023-05-24","accommodation": {"rooms": [{"rates": [{"total_currency": "GBP","total_amount": "799.00","tax_currency": "GBP","tax_amount": "82.23","supported_loyalty_programme": "duffel_hotel_group_rewards","quantity_available": 12,"payment_type": "pay_now","id": "rat_0000BTVRuKZTavzrZDJ4cb","fee_currency": "GBP","fee_amount": "50.94","due_at_accommodation_currency": "GBP","due_at_accommodation_amount": "39.95","conditions": [{"title": "Parking","description": "Public parking is available nearby for £15 per day"}],"cancellation_timeline": [{"refund_amount": "799.00","currency": "GBP","before": "2023-05-23T13:00:00Z"}],"board_type": "room_only","base_currency": "GBP","base_amount": "665.83","available_payment_methods": [["balance","card"]]}],"photos": [{"url": "https://assets.duffel.com/img/stays/image.jpg"}],"name": "Double Suite","beds": [{"type": "king","count": 2}]}],"review_score": 8.8,"rating": 3,"photos": [{"url": "https://assets.duffel.com/img/stays/image.jpg"}],"phone_number": "+442074938181","name": "The Ritz London","location": {"geographic_coordinates": {"longitude": -0.1416,"latitude": 51.5071},"address": {"region": "England","postal_code": "W1J 9BR","line_one": "150 Piccadilly","country_code": "GB","city_name": "London"}},"key_collection": {"instructions": "Please collect the keys from accommodation's reception."},"id": "acc_0000AWr2IgADo2rTllJJhI","email": "reservations@theritzlondon.com","description": "Ornate quarters, some with grand pianos, in a luxurious hotel offering acclaimed dining & a spa.","created_at": "2022-12-20T15:21:01Z","check_in_information": {"check_out_before_time": "11:30","check_in_after_time": "14:30"},"cheapest_rate_total_amount": "799.00","cheapest_rate_currency": "GBP","chain": {"name": "The Ritz-Carlton"},"amenities": [{"type": "parking","description": "Parking"}]}}}