Searching airports

Searching using a query

Search Airports using a text query

GET https://api.aviowiki.com/free/airports/search

This endpoint allows you to conduct an airport search using a free-text query string.

Query Parameters

Name	Type	Description
page	number	The page number for pagination, starting from `0` to indicate the first page.
size	number	The number of results in a page, for pagination.
query	string	The query string you want to look for.

Headers

Name	Type	Description
Authorization	String	An API Token using Bearer authorization.

200 The query succeeded and 0 or more results are returned.

{
  "page": {
    "number": 0,
    "size": 10,
    "totalPages": 1,
    "totalResults": 2
  },
  "content": [
    {
      "country": {
        "iso2": "GB",
        "iso3": "GBR",
        "isoNumeric": 826,
        "name": "United Kingdom",
        "officialName": "United Kingdom of Great Britain and Northern Ireland"
      },
      "timeZone": "Europe/London",
      "aid": "APT-FO61-WBTO",
      "coordinates": {
        "latitude": 51.4775,
        "longitude": -0.4613889
      },
      "icao": "EGLL",
      "iata": "LHR",
      "faa": null,
      "servedCity": "London",
      "servedCityGoverningDistrict": null,
      "name": "Heathrow Airport"
    },
    {
      "country": {
        "iso2": "US",
        "iso3": "USA",
        "isoNumeric": 840,
        "name": "United States",
        "officialName": "United States of America"
      },
      "timeZone": "America/Chicago",
      "aid": "APT-PEKY-N349",
      "coordinates": {
        "latitude": 44.4641394,
        "longitude": -89.3587256
      },
      "icao": null,
      "iata": null,
      "faa": "WS14",
      "servedCity": "Amherst, WI",
      "servedCityGoverningDistrict": {
        "code": "US-WI",
        "name": "Wisconsin",
        "administrativeType": "State"
      },
      "name": "Lake Ell Field"
    }
  ]
}

Format of the returned objects

The response will be a Paged List of results. Each result object contains a limited set of information that we consider to be essential to identify a location.

For this endpoint the properties available in the response are:

Property	Type	Description
aid	string	A string with the AID of the airport, with APT as namespace
icao	string, null	A string with the 4-letters ICAO code of the airport, ornull if none is assigned
iata	string, null	A string with the 3-letters IATA code of the airport, or null if none is assigned.
faa	string, null	A string with the FAA code, or null if none is assigned.
coordinates	object, null	A Coordinates object which represents the location of the Aerodrome Reference Point. This is null when the information is not known.
country	object, null	A Country object which represents the country at which an airport is located. null if this is not known.
timeZone	string, null	The timezone of the airfield as noted in the IANA Time Zone Database. null indicates that this information is not available.
name	string, null	The name of the airport. This should be the official name of the airport written in Latin characters.
servedCity	string, null	A string containing the name of the city served by the airport. In some countries, like the USA, this includes the state. For example: Los Angeles, CA. This is null when the information is not known.