LIliteapi
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

Request

  • Base URL
    https://api.liteapi.travel/v3.0
  • URL
    https://api.liteapi.travel/v3.0/flights/bookings
  • Auth
    API key in header X-API-Key

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": [
        {
          "customTags": {
            "SOURCE": "EXAMPLE",
            "TIER": "GOLD"
          },
          "status": "CONFIRMED",
          "journey": {
            "segments": [
              {
                "stops": [
                  {
                    "airportCode": "GIG",
                    "airportName": "Rio Galeão – Tom Jobim International Airport",
                    "arrivalTime": "2026-10-17T18:35:00",
                    "departureTime": "2026-10-17T19:25:00",
                    "duration": {
                      "iso8601": "PT50M",
                      "minutes": 50
                    }
                  }
                ]
              }
            ],
            "baggage": {
              "included": [
                {
                  "bagType": "cabin",
                  "description": "1 cabin bag up to 8 kg",
                  "passengerType": "ADT",
                  "pieces": 1,
                  "size": "55x40x20",
                  "unit": "kg",
                  "weightKg": 8
                }
              ],
              "paid": [
                {
                  "bagType": "cabin",
                  "description": "1 cabin bag up to 8 kg",
                  "passengerType": "ADT",
                  "pieces": 1,
                  "size": "55x40x20",
                  "unit": "kg",
                  "weightKg": 8
                }
              ]
            },
            "terms": {
              "summary": [
                {
                  "level": "warning",
                  "message": "Changes allowed with fee"
                }
              ]
            },
            "cabinClass": "ECONOMY"
          },
          "ticketedServices": [
            {
              "services": [
                {
                  "serviceId": "g6Rwc2lk2SQwMTlkMDY3NC1hMzQzLTc0OGEtYmYyYS1jMDk4ZmNjMTk2ZGGhcMtAfB6PXCj1w6Fjo1VTRA==",
                  "quantity": 1
                }
              ],
              "soldServices": [
                {
                  "serviceId": "g6Rwc2lk2SQwMTlkMDY3NC1hMzQzLTc0OGEtYmYyYS1jMDk4ZmNjMTk2ZGGhcMtAfB6PXCj1w6Fjo1VTRA==",
                  "quantity": 1
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.