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

NameTypeDescription

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

NameTypeDescription

Authorization

String

An API Token using Bearer authorization.

{
  "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.

Last updated