# 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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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.
