FLflightaware
flights

Search for flights

Search for airborne flights by matching against various parameters including geospatial data. Uses a simplified query syntax compared to /flights/search/advanced.

get/flights/search

Request

Query parameters

querystring
Example:-latlong "44.953469 -111.045360 40.962321 -104.046577"

Query to search for flights with a simplified syntax (compared to /flights/search/advanced). It should not exceed 1000 bytes in length. Query syntax allows filtering by latitude/longitude box, aircraft ident with wildcards, type with wildcards, prefix, origin airport, destination airport, origin or destination airport, groundspeed, and altitude. It takes search terms in a single string comprising "-key value" pairs. Codeshares and alternate idents are NOT searched when using the -idents clause.

Keys include:

  • -prefix STRING
  • -type STRING
  • -idents STRING
  • -identOrReg STRING
  • -airline STRING
  • -destination STRING
  • -origin STRING
  • -originOrDestination STRING
  • -aboveAltitude INTEGER
  • -belowAltitude INTEGER
  • -aboveGroundspeed INTEGER
  • -belowGroundspeed INTEGER
  • -latlong "MINLAT MINLON MAXLAT MAXLON"
  • -filter {ga|airline}
max_pagesinteger

Maximum number of pages to fetch. This is an upper limit and not a guarantee of how many pages will be returned.

cursorstring

Opaque value used to get the next batch of data from a paged collection.

Response

OK

num_pagesinteger required

Number of pages returned

Example response

{
  "flights": [
    {
      "origin": {
        "timezone": "America/New_York",
        "name": "LaGuardia",
        "city": "New York"
      },
      "destination": {
        "timezone": "America/New_York",
        "name": "LaGuardia",
        "city": "New York"
      },
      "first_position_time": "2021-12-31T19:59:59Z",
      "last_position": {
        "timestamp": "2021-12-31T19:59:59Z"
      },
      "actual_off": "2021-12-31T19:59:59Z",
      "actual_on": "2021-12-31T19:59:59Z",
      "foresight_predictions_available": true
    }
  ]
}

Changes

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