SEseats

Live Search

Changed on
post/live

Request

  • Base URL
    https://seats.aero/partnerapi
  • URL
    https://seats.aero/partnerapi/live
  • Auth
    API key in header Partner-Authorization

Request body

origin_airportstring required

The origin airport to search from.

destination_airportstring required

The destination airport to search to.

departure_datestring required

Departure date to search, in YYYY-MM-DD format.

sourcestring required

The mileage program to search. Can be one of the sources in Concepts.

disable_filtersboolean

Disables filters for dynamic pricing and mismatched airports. Where supported by the mileage program, this may also return mixed-cabin itineraries. Results with a computed mixed-cabin percentage include MixedCabinPct.

show_dynamic_pricingboolean

Disables only filters for dynamic pricing, but not for mismatched airports.

smart_cacheboolean

When true, an eligible failed live search can return matching cached availability instead. The fallback preserves the requested source, airports, departure date, seat count, filter settings, and stored result identifiers. Cache-resolved responses do not create live provider billing records. Definitive unsupported-source or unsupported-route responses do not use the fallback. If no matching cached search exists, the original live-search error is returned.

seat_countinteger

Number of adult passengers to search for, between 1-9 seats.

Response

200

successboolean
cachedboolean

True when an opted-in request was resolved from cached availability after the live search failed. Omitted for live results.

Example response

{
  "results": [
    {
      "ID": "2v37fWFcRCmlct2SFweD9Np5cVH",
      "AvailabilitySegments": [
        {
          "ID": "2v37fS4eggp7hpqwzBQbpFhoRlz",
          "FlightNumber": "QF433",
          "Distance": 439,
          "OriginAirport": "SYD",
          "DestinationAirport": "MEL",
          "DepartsAt": "2025-05-20T10:00:00Z",
          "ArrivesAt": "2025-05-20T11:35:00Z",
          "CreatedAt": "0001-01-01T00:00:00Z",
          "UpdatedAt": "0001-01-01T00:00:00Z",
          "Source": "qantas"
        }
      ],
      "TotalDuration": 270,
      "Stops": 1,
      "Carriers": "QF",
      "MileageCost": 18000,
      "TotalTaxes": 9489,
      "TaxesCurrency": "AUD",
      "TaxesCurrencySymbol": "$",
      "FlightNumbers": "QF433, QF616",
      "DepartsAt": "2025-05-20T10:00:00Z",
      "Cabin": "economy",
      "ArrivesAt": "2025-05-20T14:30:00Z",
      "CreatedAt": "0001-01-01T00:00:00Z",
      "UpdatedAt": "0001-01-01T00:00:00Z",
      "Source": "qantas",
      "MixedCabinPct": 25
    }
  ],
  "bookingLinks": [
    {
      "label": "Book via Qantas Frequent Flyer",
      "link": "https://www.qantas.com/us/en/book-a-trip/flights.html?showMod=0&utm_source=seatsaero",
      "primary": true
    }
  ],
  "success": true,
  "cached": true
}

Changes

  • 56fb03865e00Revision changes
    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property // to the response with the status