get/search

Request

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

Query parameters

origin_airportstring required

A list of origin airports. Comma-delimited if multiple, such as "SFO,LAX".

destination_airportstring required

A list of destination airports. Comma-delimited if multiple, such as "FRA,LHR".

start_datestring

Results must depart between start_date and end_date when specified, in YYYY-MM-DD format.

end_datestring

Results must depart between start_date and end_date when specified, in YYYY-MM-DD format.

cursorinteger

A cursor you obtained from a previous search call.

takeinteger

Maximum amount of results to respond with. Must be >= 10 and <= 1000.

order_bystring

By default, results are ordered by departure date and then by available cabins, with available premium cabins ranked above results without them available. You can alternatively specify lowest_mileage in this parameter to return results with the cheapest prices first.

skipinteger

How many results to skip.

include_tripsboolean

Include trip-level details in the API response. This may degrade response time and sizing.

only_direct_flightsboolean

Only return results that have a direct flight available. Respects the cabin parameter if provided.

carriersstring

Only return results involving these comma-separated carriers (i.e. "DL,AA"). Respects the cabin parameter if provided.

include_filteredboolean

Return results that only have raw (filtered) results. Enable this when using the raw fields to prevent dynamic price filtering.

sourcesstring

A list of mileage programs to filter by. Comma-delimited if multiple, such as "aeroplan,united".

minify_tripsboolean

When include_trips and minify_trips are both enabled, returns a reduced amount of fields in each trip to improve performance.

cabinsstring

Results must have these cabins available when specified. Comma-delimited if multiple, such as "economy,business". Must not be provided if "cabin" was provided.

min_cabin_pctinteger

Minimum percentage of each itinerary's distance that must be flown in its reported Cabin or a higher cabin. Must be a whole number from 0 to 100. For example, 75 permits up to 25% of the journey in a lower cabin. Omit this parameter or set it to 100 to exclude itineraries with any distance below the reported Cabin.

Response

200

countinteger
hasMoreboolean
cursorinteger

Changes

    • breaking

      the response property // became nullable for the status

    • breaking

      the // response's property type changed from no type to array null for status

    • info

      added the new optional query request parameter min_cabin_pct