DATE:
AUTHOR:
The Duffel team

Multiple booking references for orders

DATE:
AUTHOR: The Duffel team

We've enhanced our Orders API to support multiple booking references, giving you better visibility into all the carrier references associated with your bookings.

What's new

Orders now include a booking_references array that contains all carrier booking references (PNRs) associated with the order. This includes the primary booking reference as well as any additional references from other carriers involved in the booking.

Each booking reference includes:

  • booking_reference: The airline reference for the order (PNR or record locator)

  • carrier: The airline that issued this booking reference

Why this matters

This enhancement solves a key gap for codeshare and interline bookings. Previously, you only received the primary booking reference, but many airline services require the specific PNR for the operating carrier.

You'll now have access to all carrier booking references, enabling your customers to:

  • Select seats directly with operating carriers on codeshare flights

  • Check in with the correct airline using their specific PNR

This is particularly valuable for complex itineraries where each carrier issues their own booking reference.

Backward compatibility

The existing booking_reference field remains unchanged and continues to return the primary booking reference for the order, ensuring your existing integrations continue to work seamlessly.

Example

{
  "id": "ord_0000A3bQ8Qj8Qj8Qj8Qj8Q",
  "booking_reference": "RZPNX8",
  "booking_references": [
    {
      "booking_reference": "RZPNX8",
      "carrier": {
        "id": "arl_00001876aqC8c5umZmrRds",
        "iata_code": "AA",
        "name": "American Airlines",
        "conditions_of_carriage_url": "https://www.aa.com/i18n/customer-service/support/conditions-of-carriage.jsp",
        "logo_lockup_url": "https://assets.duffel.com/img/airlines/for-light-background/full-color-lockup/AA.svg",
        "logo_symbol_url": "https://assets.duffel.com/img/airlines/for-light-background/full-color-logo/AA.svg"
      }
    },
    {
      "booking_reference": "BA456",
      "carrier": {
        "id": "arl_00001876aqC8c5umZmrRds",
        "iata_code": "BA",
        "name": "British Airways",
        "conditions_of_carriage_url": "https://www.britishairways.com/en-gb/information/legal/british-airways/general-conditions-of-carriage",
        "logo_lockup_url": "https://assets.duffel.com/img/airlines/for-light-background/full-color-lockup/BA.svg",
        "logo_symbol_url": "https://assets.duffel.com/img/airlines/for-light-background/full-color-logo/BA.svg"
      }
    }
  ]
}
Powered by LaunchNotes