1. Home
  2. Docs
  3. Airports
  4. Authenticated API Endpoints
  5. Airport Search

Airport Search

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

The basic functionalities are similar to the Free endpoint however, with this Authenticated endpoint you can access more properties and also use location-based query.

Endpoint

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

Request Example

curl --request GET \
  --url 'https://api.aviowiki.com/airports/search?query=Tallinn&lat=59.439326&lon=24.763387&distance=150&size=5&page=0' \
  --header 'authorization: Bearer 00112233-4455-6677-8899-aabbccddeeff'

Test it now

Request Parameters

The following parameters allow making simple or advanced searches.

The query parameter can be used alone or combined with the geographical parameters (lat, lon and distance) to filter airports around a location using a text string.

The minimum amount of parameters required is either query or lat and lon.

NameTypeLocationDescription
querystringQuery StringThe text to search in the database.
latnumberQuery StringThe latitude on which to centre the search.
lonnumberQuery StringThe longitude on which to centre the search.
distancenumberQuery StringThe maximum distance of the results, in kilometres, from the point identified by lat and lon.
If not supplied, this parameter is defaulted to 100 in case lat and lon are provided.
pagenumberQuery StringThe page number for pagination
sizenumberQuery StringThe size of the pages for pagination

Response

The response will be a Paged List of results. Each result object contains information useful to be displayed in a search context.

Below are the properties used in each search result:

PropertyTypeDescription
aidstringA string with the AID of the airport, with APT as namespace
icaostring, nullA string with the 4-letters ICAO code of the airport, ornull if none is assigned
iatastring, nullA string with the 3-letters IATA code of the airport, or null if none is assigned.
faastring, nullA string with the FAA code, or null if none is assigned.
coordinatesobject, nullA Coordinates object which represents the location of the Aerodrome Reference Point.
This is null when the information is not known.
countryobject, nullA Country object which represents the country at which an airport is located.
null if this is not known.
timeZonestring, nullThe timezone of the airfield as noted in the IANA Time Zone Database.
null indicates that this information is not available.
namestring, nullThe name of the airport. This should be the official name of the airport written in Latin characters.
servedCitystring, nullA 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.
openingIndicatorstringAn indication of the current availability of the airport.
possible values are OPEN, SEE_TIMES, CLOSED, UNKNOWN. For full details on this property see the Availability Data Model article.
iconstringAn indicator of which icon should be displayed for this airport.
Possible values are CIVIL, MILITARY, JOINT, WATERPORT, HELIPORT, OTHER.
distanceFromSearchCoordinatesnumberThe distance in kilometers between this result and the point specified by lat and lon, if these were used.

Example Reply

Below is an example of the reply obtained with the example search above.

{
   "page": {
     "number": 0,
     "size": 5,
     "totalPages": 1,
     "totalResults": 2
   },
   "content": [
     {
       "aid": "APT-FYOP-J93M",
       "icao": "EECL",
       "iata": "CHE",
       "faa": null,
       "name": "Tallinn/city Hall",
       "coordinates": {
         "latitude": 59.4480556,
         "longitude": 24.7533333
       },
       "servedCity": null,
       "country": {
         "iso3": "EST",
         "iso2": "EE",
         "isoNumeric": 233,
         "name": "Estonia",
         "continent": "Europe"
       },
       "timeZone": "Europe/Tallinn",
       "openingIndicator": "UNKNOWN",
       "icon": "OTHER",
       "distanceFromSearchCoordinates": 1.1248262748172175
     },
     {
       "aid": "APT-NCK6-N3CI",
       "icao": "EETN",
       "iata": "TLL",
       "faa": null,
       "name": "Lennart Meri Tallinn",
       "coordinates": {
         "latitude": 59.4133333,
         "longitude": 24.8325
       },
       "servedCity": null,
       "country": {
         "iso3": "EST",
         "iso2": "EE",
         "isoNumeric": 233,
         "name": "Estonia",
         "continent": "Europe"
       },
       "timeZone": "Europe/Tallinn",
       "openingIndicator": "UNKNOWN",
       "icon": "OTHER",
       "distanceFromSearchCoordinates": 4.861431934838745
     }
   ]
 }
Was this article helpful to you? Yes No

How can we help?