Accessing Leisure Private Fares

Overview

Leisure private fares are specially discounted fares contracted between airlines and agents for non-corporate use cases—for example student, tour operator, or other negotiated leisure fare types.
If you have leisure fares filed with airlines, you can use the Duffel API to request them by setting a fare_type on each passenger for whom private fares apply. You can request leisure private fares in the same offer request as corporate negotiated fares.

Request

The request parameters are the same as for creating an offer request, except for each passenger for which leisure private fares are expected, the fare_type field is passed. For some fare types involving children or infants you can pass in age as well.
Shell
curl -X POST --compressed "https://api.duffel.com/air/offer_requests" 
  -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": {
    "passengers": [
      {
        "fare_type": "student"
      },
      {
        "fare_type": "contract_bulk_child",
        "age": 5
      }
    ],
    "slices": [
      {
        "origin": "LHR",
        "destination": "JFK",
        "departure_date": "2023-12-24"
      },
      {
        "origin": "JFK",
        "destination": "LHR",
        "departure_date": "2023-12-02"
      }
    ]
  }
}'

Response

The response is the same as after creating an offer request, except that the offers which have private fares applied are labelled with a private_fares object. If private_fares list is empty, then private fares are not applied on that offer.
JSON
{
  "id": "orq_00009hthhsUZ8W4LxQghdf",
  // [...]
  "offers": [
    {
      // [...]
      "id": "off_00009htYpSCXrwaB9DnUm0_0",
      "slices": [...]
       "private_fares": [
          {
            "type": "leisure"
          }
        ]
     //...
    }
  ]
}

Airlines support and other considerations

Duffel exposes a set of fare types for leisure private fares. Different airlines support a different subset of these. You should know the fare types supported as you would have filed them with the airlines. If you want to add a fare type that you already have filed with the airline but not exposed by us then contact us. Passing an unsupported fare type for an airline will result in getting no private fare or any offers for that airline.
For corporate negotiated fares (corporate_code, tour_code, and related parameters), see Accessing corporate private fares.

Keep learning

This is how you request leisure private fares during offer request creation. The following steps to create an order are the same as other flows.