v1

latestOpenAPI 3.0.02026-07-247251950.2 KB
Flight Bookings

List bookings

Overview

List confirmed flight bookings owned by the authenticated user. Supports an optional PNR + last-name lookup for retrieving a single booking.

When to Use

  • "My bookings" page - Display the authenticated user's confirmed flight bookings
  • PNR lookup - Retrieve a single booking by airlinePnr and a passenger's lastName
  • Booking management - Build dashboards or list views of past and upcoming reservations

What You Get

  • Confirmed bookings only - Returns records persisted from the booking flow;
  • Full booking objects with status, journey, passengers, order reference, and pricing
  • Sandbox isolation - Sandbox and live bookings are scoped by the API key used

Key Features

  • Owner-scoped: Only returns bookings belonging to the authenticated user
  • PNR + last-name lookup: When both airlinePnr and lastName are supplied, returns a single matching booking; both are required together
  • Stable response shape: data is always an array containing exactly one element with a bookings array

Quick Start

Call with no query parameters to list all bookings for the authenticated user. To look up a specific booking, pass both airlinePnr and lastName.

get/flights/bookings

Query parameters

airlinePnrstring

Airline PNR (record locator) for single-booking lookup. Required together with lastName.

lastNamestring

Passenger last name for single-booking lookup. Required together with airlinePnr.

Response

Successful response

Example response

{
  "data": [
    {
      "bookings": [
        {
          "selectedServices": [
            {
              "serviceId": "g6Rwc2lk2SQwMTlkMDY3NC1hMzQzLTc0OGEtYmYyYS1jMDk4ZmNjMTk2ZGGhcMtAfB6PXCj1w6Fjo1VTRA==",
              "quantity": 1
            }
          ]
        }
      ]
    }
  ]
}