Offers

After you've searched for flights by creating an offer request, we'll send your search to a range of airlines, which may return offers.

Each offer represents flights you can buy from an airline at a particular price that meet your search criteria.

You'll see slices inside the offers. Each slice will also include a list of one or more specific flights (called segments) that the airline is offering to get the passengers where they want to go.

An offer is only available to create an order for a limited time by the traveller before it expires, typically within 30 minutes. Exact time is indicated by the expires_at field.

Schema

available_airline_credit_ids
The IDs of airline credits that can be used to pay for this offer. Each ID represents a credit that can be applied as a payment method when creating an order from this offer.

Example:["acd_00009htYpSCXrwaB9DnUm1","acd_00009htYpSCXrwaB9DnUm2"]

available_services
The services that can be booked along with the offer but are not included by default, for example an additional checked bag.

base_amount
The base price of the offer for all passengers, excluding taxes. It does not include the base amount of any service(s).

Example:"30.20"

base_currency
The currency of the base_amount, as an ISO 4217 currency code. It will match your organisation's billing currency...

Example:"GBP"

conditions
The conditions associated with this offer, describing the kinds of modifications you can make post-booking and any penalties that will apply.

created_at
The ISO 8601 datetime at which the offer was created.

Example:"2020-01-17T10:12:14.545Z"

expires_at
The expiry of the offer before which the traveller should use this offer to create an order.

Example:"2020-01-17T10:42:14.545Z"

id
Duffel's unique identifier for the resource.

Example:"off_00009htYpSCXrwaB9DnUm0"

intended_payment_methods
The payment methods that will be used to pay for the offer and their fees if any.

live_mode
Whether the offer request was created in live mode. This field will be set to true if the offer request was created in live mode, or false if it was created in test mode.

Example:true

owner
The airline which provided the offer.

passenger_identity_documents_required
Whether identity documents must be provided for each of the passengers when creating an order based on this offer. If this is true, you must provide a passport document for every passenger.

Example:false

passengers
The passengers included in the offer.

payment_requirements
The payment requirements for this offer.

private_fares
The private fares applied on this offer.

slices
The slices that make up this offer. Each slice will include one or more segments, the specific flights that the airline is offering to take the passengers from the slice's origin to its destination.

supported_loyalty_programmes
A list of airline IATA codes whose loyalty programmes are supported when booking the offer.

Example:["AF","KL","DL"]

supported_passenger_identity_document_types
The types of identity documents supported by the airline and may be provided for the passengers when creating an order based on this offer.

Example:["passport"]

tax_amount
The amount of tax payable on the offer for all passengers.

Example:"40.80"

tax_currency
The currency of the tax_amount, as an ISO 4217 currency code.

Example:"GBP"

total_amount
The total price of the offer for all passengers, including taxes.

Example:"45.00"

total_currency
The currency of the total_amount, as an ISO 4217 currency code.

Example:"GBP"

total_emissions_kg
An estimate of the total carbon dioxide (CO₂) emissions when all of the passengers fly this offer's itinerary, measured in kilograms.

Example:"460"

updated_at
The ISO 8601 datetime at which the offer was last updated.

Example:"2020-01-17T10:12:14.545Z"

Get a single offer

You should use this API to get the complete, up-to-date information about an offer. This endpoint does not guarantee that the offer will be available at the time of booking.