Creating a booking using the selected offer

POST https://api.duffel.com/air/orders

We are finally ready to make a booking using the Duffel API which we call creating an order.

For this you'll need three things: 1. The ID of the offer you'd like to book (taken from the previous request you did) 2. Basic necessary information about the passengers 3. Payment method and information to confirm the order

Request Body

{"data"=>{"selected_offers"=>["{{OFFER_ID}}"], "payments"=>[{"type"=>"balance", "currency"=>"{{TOTAL_CURRENCY}}", "amount"=>"{{TOTAL_AMOUNT}}"}], "passengers"=>[{"phone_number"=>"+442080160508", "email"=>"tony@example.com", "born_on"=>"1980-07-24", "title"=>"mr", "gender"=>"m", "family_name"=>"Stark", "given_name"=>"Tony", "infant_passenger_id"=>"{{INFANT_PASSENGER_ID}}", "id"=>"{{ADULT_PASSENGER_ID_1}}"}, {"phone_number"=>"+442080160509", "email"=>"potts@example.com", "born_on"=>"1983-11-02", "title"=>"mrs", "gender"=>"m", "family_name"=>"Potts", "given_name"=>"Pepper", "id"=>"{{ADULT_PASSENGER_ID_2}}"}, {"phone_number"=>"+442080160506", "email"=>"morgan@example.com", "born_on"=>"2021-08-24", "title"=>"mrs", "gender"=>"f", "family_name"=>"Stark", "given_name"=>"Morgan", "id"=>"{{INFANT_PASSENGER_ID}}"}]}}

HEADERS

RESPONSES

status: Created

{"data":{"total_currency":"GBP","total_amount":"8618.36","tax_currency":"GBP","tax_amount":"1314.67","slices":[{"segments":[{"passengers":[{"passenger_id":"pas_0000A6jrO9peO6kSPxwgAi","cabin_class_marketing_name":"Business","cabin_class":"business","baggages":[{"type":"checked","quantity":1}]},{"passenger_id":"pas_0000A6jrO9peO6kSPxwgAj","cabin_class_marketing_name":"Business","cabin_class":"business","baggages":[{"type":"checked","quantity":1}]},{"passenger_id":"pas_0000A6jrO9peO6kSPxwgAk","cabin_class_marketing_name":"Business","cabin_class":"business","baggages":[{"type":"checked","quantity":1}]}],"origin_terminal":"2","origin":{"type":"airport","time_zone":"America/New_York","name":"New York Stewart International Airport","longitude":-74.102724,"latitude":41.501292,"id":"arp_swf_us","icao_code":"KSWF","iata_country_code":"US","iata_code":"SWF","iata_city_code":"NYC","city_name":"Newburgh","city":{"type":"city","time_zone":null,"name":"New York","longitude":null,"latitude":null,"id":"cit_nyc_us","icao_code":null,"iata_country_code":"US","iata_code":"NYC","iata_city_code":"NYC","city_name":null}},"operating_carrier_flight_number":"2117","operating_carrier":{"name":"Duffel Airways","id":"arl_00009VME7D6ivUu8dn35WK","iata_code":"ZZ"},"marketing_carrier_flight_number":"2117","marketing_carrier":{"name":"Duffel Airways","id":"arl_00009VME7D6ivUu8dn35WK","iata_code":"ZZ"},"id":"seg_0000A6jrOALuSAYK212RSC","duration":"PT2H23M","distance":"1360.5217397388235","destination_terminal":"7","destination":{"type":"airport","time_zone":"America/New_York","name":"Hartsfield-Jackson Atlanta International Airport","longitude":-84.4279,"latitude":33.638714,"id":"arp_atl_us","icao_code":"KATL","iata_country_code":"US","iata_code":"ATL","iata_city_code":"ATL","city_name":"Atlanta","city":{"type":"city","time_zone":null,"name":"Atlanta","longitude":null,"latitude":null,"id":"cit_atl_us","icao_code":null,"iata_country_code":"US","iata_code":"ATL","iata_city_code":"ATL","city_name":null}},"departure_terminal":"2","departure_datetime":"2021-06-21T23:00:00","departing_at":"2021-06-21T23:00:00","arriving_at":"2021-06-22T01:23:00","arrival_terminal":"7","arrival_datetime":"2021-06-22T01:23:00","aircraft":{"name":"Boeing 777-300","id":"arc_00009VMF8AhXSSRnQDI6HE","iata_code":"773"}}],"origin_type":"airport","origin":{"type":"airport","time_zone":"America/New_York","name":"New York Stewart International Airport","longitude":-74.102724,"latitude":41.501292,"id":"arp_swf_us","icao_code":"KSWF","iata_country_code":"US","iata_code":"SWF","iata_city_code":"NYC","city_name":"Newburgh","city":{"type":"city","time_zone":null,"name":"New York","longitude":null,"latitude":null,"id":"cit_nyc_us","icao_code":null,"iata_country_code":"US","iata_code":"NYC","iata_city_code":"NYC","city_name":null}},"id":"sli_0000A6jrRyyigRp9uj0liC","duration":"PT2H23M","destination_type":"airport","destination":{"type":"airport","time_zone":"America/New_York","name":"Hartsfield-Jackson Atlanta International Airport","longitude":-84.4279,"latitude":33.638714,"id":"arp_atl_us","icao_code":"KATL","iata_country_code":"US","iata_code":"ATL","iata_city_code":"ATL","city_name":"Atlanta","city":{"type":"city","time_zone":null,"name":"Atlanta","longitude":null,"latitude":null,"id":"cit_atl_us","icao_code":null,"iata_country_code":"US","iata_code":"ATL","iata_city_code":"ATL","city_name":null}},"conditions":{"change_before_departure":{"penalty_currency":"GBP","penalty_amount":"1460.00","allowed":true}},"changeable":null},{"segments":[{"passengers":[{"passenger_id":"pas_0000A6jrO9peO6kSPxwgAi","cabin_class_marketing_name":"Business","cabin_class":"business","baggages":[{"type":"checked","quantity":1}]},{"passenger_id":"pas_0000A6jrO9peO6kSPxwgAj","cabin_class_marketing_name":"Business","cabin_class":"business","baggages":[{"type":"checked","quantity":1}]},{"passenger_id":"pas_0000A6jrO9peO6kSPxwgAk","cabin_class_marketing_name":"Business","cabin_class":"business","baggages":[{"type":"checked","quantity":1}]}],"origin_terminal":"2","origin":{"type":"airport","time_zone":"America/New_York","name":"Hartsfield-Jackson Atlanta International Airport","longitude":-84.4279,"latitude":33.638714,"id":"arp_atl_us","icao_code":"KATL","iata_country_code":"US","iata_code":"ATL","iata_city_code":"ATL","city_name":"Atlanta","city":{"type":"city","time_zone":null,"name":"Atlanta","longitude":null,"latitude":null,"id":"cit_atl_us","icao_code":null,"iata_country_code":"US","iata_code":"ATL","iata_city_code":"ATL","city_name":null}},"operating_carrier_flight_number":"9169","operating_carrier":{"name":"Duffel Airways","id":"arl_00009VME7D6ivUu8dn35WK","iata_code":"ZZ"},"marketing_carrier_flight_number":"9169","marketing_carrier":{"name":"Duffel Airways","id":"arl_00009VME7D6ivUu8dn35WK","iata_code":"ZZ"},"id":"seg_0000A6jrOALuSAYK212RSE","duration":"PT2H23M","distance":"1360.5217397388235","destination_terminal":"7","destination":{"type":"airport","time_zone":"America/New_York","name":"New York Stewart International Airport","longitude":-74.102724,"latitude":41.501292,"id":"arp_swf_us","icao_code":"KSWF","iata_country_code":"US","iata_code":"SWF","iata_city_code":"NYC","city_name":"Newburgh","city":{"type":"city","time_zone":null,"name":"New York","longitude":null,"latitude":null,"id":"cit_nyc_us","icao_code":null,"iata_country_code":"US","iata_code":"NYC","iata_city_code":"NYC","city_name":null}},"departure_terminal":"2","departure_datetime":"2021-07-21T23:00:00","departing_at":"2021-07-21T23:00:00","arriving_at":"2021-07-22T01:23:00","arrival_terminal":"7","arrival_datetime":"2021-07-22T01:23:00","aircraft":{"name":"Boeing 777-300","id":"arc_00009VMF8AhXSSRnQDI6HE","iata_code":"773"}}],"origin_type":"airport","origin":{"type":"airport","time_zone":"America/New_York","name":"Hartsfield-Jackson Atlanta International Airport","longitude":-84.4279,"latitude":33.638714,"id":"arp_atl_us","icao_code":"KATL","iata_country_code":"US","iata_code":"ATL","iata_city_code":"ATL","city_name":"Atlanta","city":{"type":"city","time_zone":null,"name":"Atlanta","longitude":null,"latitude":null,"id":"cit_atl_us","icao_code":null,"iata_country_code":"US","iata_code":"ATL","iata_city_code":"ATL","city_name":null}},"id":"sli_0000A6jrRyyigRp9uj0liD","duration":"PT2H23M","destination_type":"airport","destination":{"type":"airport","time_zone":"America/New_York","name":"New York Stewart International Airport","longitude":-74.102724,"latitude":41.501292,"id":"arp_swf_us","icao_code":"KSWF","iata_country_code":"US","iata_code":"SWF","iata_city_code":"NYC","city_name":"Newburgh","city":{"type":"city","time_zone":null,"name":"New York","longitude":null,"latitude":null,"id":"cit_nyc_us","icao_code":null,"iata_country_code":"US","iata_code":"NYC","iata_city_code":"NYC","city_name":null}},"conditions":{"change_before_departure":{"penalty_currency":"GBP","penalty_amount":"1460.00","allowed":true}},"changeable":null}],"services":[],"payment_status":{"price_guarantee_expires_at":null,"payment_required_by":null,"awaiting_payment":false},"passengers":[{"type":"adult","title":"mr","infant_passenger_id":null,"id":"pas_0000A6jrO9peO6kSPxwgAi","given_name":"Tony","gender":"m","family_name":"Stark","born_on":"1980-07-24"},{"type":"adult","title":"mrs","infant_passenger_id":null,"id":"pas_0000A6jrO9peO6kSPxwgAj","given_name":"Pepper","gender":"m","family_name":"Potts","born_on":"1983-11-02"},{"type":"infant_without_seat","title":"mrs","infant_passenger_id":null,"id":"pas_0000A6jrO9peO6kSPxwgAk","given_name":"Morgan","gender":"f","family_name":"Stark","born_on":"2019-08-24"}],"owner":{"name":"Duffel Airways","id":"arl_00009VME7D6ivUu8dn35WK","iata_code":"ZZ"},"live_mode":false,"id":"ord_0000A6jrRyyMhlXZtcqU9w","documents":[{"unique_identifier":"1","type":"electronic_ticket"},{"unique_identifier":"2","type":"electronic_ticket"},{"unique_identifier":"3","type":"electronic_ticket"}],"created_at":"2021-04-29T12:36:18.842854Z","conditions":{"refund_before_departure":{"penalty_currency":null,"penalty_amount":null,"allowed":false},"change_before_departure":{"penalty_currency":"GBP","penalty_amount":"1460.00","allowed":true}},"cancelled_at":null,"booking_reference":"QAW35J","base_currency":"GBP","base_amount":"7303.69"}}