Flight order details

to retrieve detailed information about flight bookings and support post-booking workflows such as displaying booking details, generating travel communications, reporting commissions and reconciliation..

Retrieve flight order details

→ Use /orders/details/flights to retrieve detailed information for one or more flight orders.

You can request flight order details using either order IDs or reservation IDs. The request supports the following fields:

Parameter	Description
`orders`	Required when reservations is not provided. List of flight order IDs to retrieve. Supports up to 100 IDs.
`reservations`	Required when `orders` is not provided. A list of flight reservation IDs to retrieve. Supports up to 100 IDs.
`currency`	Optional. The currency in which monetary amounts should be returned, where applicable.

Specify either orders or reservations, but not both.

Example request

{
    "currency": "EUR",
    "orders": [
      "1234567890123456",
      "9876543210987654"
    ]
}

Response

The response returns a data array containing the flight order details returned for the request.

Common fields include:

Parameter	Description
`id`	The order identifier.
`reservation`	Reservation identifier associated with the flight booking.
`currency`	Booker and order currency.
`itineraries`	The flight itinerary information, including departure and arrival airports and timestamps.
`label`	An identifier associated with the order, which can be used for attribution or reporting purposes.
`price`	Total price in both the booker and order currencies. See the Pricing guide for details.
`status`	Current status of the flight order.

Itinerary information

The itineraries array contains the departure and arrival details for each itinerary entry, including:

Departure airport, represented by an IATA airport code.
Departure date and time.
Arrival airport, represented by an IATA airport code.
Arrival date and time.

Each itinerary entry contains the following fields:

	Description
`departure`	The departure airport and date and time.
`arrival`	The arrival airport and date and time.
`airport`	A three-letter code that uniquely identifies an airport, as defined by the International Air Transport Association (IATA).
`date_time`	The departure or arrival date and time in ISO 8601 format.

Use the /common/locations/airports endpoint to check accepted airport codes.

Pricing

The price object returns the total booking amount in:

booker_currency – The traveller's currency.
order_currency – The currency in which the order was created.

If the currency request parameter is specified, returned monetary values are converted where applicable.

Example response

{
  "request_id": "01jeayp0a7v6abn2fsjhm3jdkt",
  "data": [
    {
      "id": "ORDER_ID",
      "reservation": "RESERVATION_ID",
      "currency": {
        "booker_currency": "EUR",
        "order_currency": "USD"
      },
      "itineraries": [
        {
          "departure": {
            "airport": "CAI",
            "date_time": "2024-03-01T07:00:00+00:00"
          },
          "arrival": {
            "airport": "LXR",
            "date_time": "2024-03-01T08:10:00+00:00"
          }
        }
      ],
      "label": "SAMPLE_LABEL",
      "price": {
        "booker_currency": 197.87,
        "order_currency": 212.86
      },
      "status": "booked"
    }
  ]
}

Order status

Order status	Description
`booked`	The flight booking has been successfully confirmed.
`cancelled`	The booking has been cancelled.
`no_show`	The traveller did not show up for the flight booking.
`unknown`	The current status is unknown or not available.

Next steps

Related guides:

Understand cancellation policies.
Learn how to cancel orders.
Use labels and attribution for reporting and reconciliation.