Searching airports

Search for airports using a text query or additional options and filters.

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

This endpoint allows you to conduct an airport search using a free-text query string. It further allows to restrict the search results to certain locations based on filters passed as query parameters.

Query Parameters

NameTypeDescription

query

String

The query string (name, city etc.) you want to look for.

page

Number

The page number for pagination, starting from 0 to indicate the first page. Default: 0

size

Number

The number of results in a page, for pagination. Default: 10

types

List

A comma-separated list of airport types to return. Possible options are AIRPORT, HELIPORT, AIRSTRIP, WATER.

If set it limits the returned locations to those with matching types in the type field.

accepts

List

A comma-separated list of the accepted types of traffic. Possible options are SCHEDULED, NON_SCHEDULED, GENERAL_AVIATION, TRAINING, BUSINESS_AVIATION, MILITARY, HELICOPTER.

If set it limits the returned locations to those with matching types in the accessibleFor field.

requiresPermission

Boolean

If set to true, returns locations that have any value in nonScheduledPermission except for NONE or null.

If set to false, returns location that have only NONE or null as nonScheduledPermission.

isVfr

Boolean

If set to true, returns locations that allow VFR traffic.

If set to false, returns locations that

regions

List

country

String

countries

List

governingDistrict

String

minimumRunwayLength

Double

Minimum runway TORA the returned airports need to have. If set, it limits the returned locations to those that have at least one runway with TORA at least minimumRunwayLength.

maximumRunwayLength

Double

Maximum TORA the returned airports need to have. If set, it limits the returned locations to those that's runways have TORA at most maximumRunwayLength.

minimumRunwayWidth

Double

Minimum runway width the returned airports need to have. If set, it limits the returned locations to those that have at least one runway with width at least minimumRunwayWidth.

maximumElevation

Double

Maximum elevation the returned airports need to have. If set, it limits the returned locations to those that have elevation at most maximumElevation.

latitude

Double

Latitude of the reference point to search locations around.

longitude

Double

Longitude of the reference point to search locations around.

distance

Double

Maximum great circle distance in kilometers the returned locations need to be from the reference point set by the latitude and longitude parameters. Default: 100

Headers

NameTypeDescription

Authorization*

String

An API Token using Bearer authorization.

Detailed properties of the pagination can be found at Pagination.

Properties of the contained airports:

Property

Type

Description

aid

String

Aviowiki ID of the airport, with APT as namespace

name

String

The name of the airport. This should be the official name of the airport written in Latin characters.

country

A Country object which represents the country at which an airport is located.

timeZone

String

The time-zone of the airfield as noted in the IANA Time Zone Database. Defaults to null when this information is not available.

coordinates

Coordinates object which represents the location of the Aerodrome Reference Point. Defaults to null if the information is not known.

icao

String

A string with the 4-letters ICAO code of the airport, or null if none is assigned

iata

String

A string with the 3-letters IATA code of the airport, or null if none is assigned.

localIdentifier

String

An identifier issued by the local authority, which is not recognised as an official ICAO or IATA code. The name of the code for each country can be found in Country.localIdentifierName

servedCityGoverningDistrict

A Governing District object indicating the Governing District of the servedCity.

Defaults to null when the information is not known.

servedCity

String

A string containing the name of the city served by the airport.

Defaults to null when the information is not known.

elevation

Decimal

A decimal number representing the elevation of the airport expressed in meters. Two decimal positions are provided, for precise conversion to feet. Defaults to null when the information is not known.

longestRunwayLength

Decimal

Longest runway length expressed in meters with precision up to two decimal positions. Defaults to null when this information is not available.

widestRunwayWidth

Decimal

The widest runway width expressed in meters with precision up to two decimal positions. Defaults to null when this information is not available.

openingIndicator

String

Opening indicator flag taking into consideration the 4 types of airport availability. For details see opening indicator section. Available values: OPEN, SEE_TIMES, CLOSED, UNKNOWN Defaults to null when this information is not available.

distanceFromSearchCoordinates

Decimal

Distance from the search coordinates given in the query expressed in kilometers with precision up to two decimal positions. Defaults to null when no search coordinates were given in the query.

operationalStatus

String

Worst criticality of the valid operational notes for the airport. Available values: INFORMATION_ONLY, OPERATIONALLY_RELEVANT, OPERATIONALLY_CRITICAL Defaults to null when no operational notes are present for the airport.

Retrieve random airports

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

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

Headers

NameTypeDescription

Authorization

String

An API Token using Bearer authorization.

Property

Type

Description

name

String

The name of the airport. This should be the official name of the airport written in Latin characters.

country

A Country object which represents the country at which an airport is located.

timeZone

String

The time-zone of the airfield as noted in the IANA Time Zone Database. Defaults to null when this information is not available.

aid

String

Aviowiki ID of the airport, with APT as namespace

coordinates

Coordinates object which represents the location of the Aerodrome Reference Point. Defaults to null if the information is not known.

icao

String

A string with the 4-letters ICAO code of the airport, or null if none is assigned

iata

String

A string with the 3-letters IATA code of the airport, or null if none is assigned.

localIdentifier

String

An identifier issued by the local authority, which is not recognised as an official ICAO or IATA code. The name of the code for each country can be found in Country.localIdentifierName

servedCityGoverningDistrict

A Governing District object indicating the Governing District of the servedCity.

Defaults to null when the information is not known.

servedCity

String

A string containing the name of the city served by the airport.

Defaults to null when the information is not known.

elevation

Decimal

A decimal number representing the elevation of the airport expressed in meters. Two decimal positions are provided, for precise conversion to feet. Defaults to null when the information is not known.

longestRunwayLength

Decimal

Longest runway length expressed in meters with precision up to two decimal positions. Defaults to null when this information is not available.

widestRunwayWidth

Decimal

The widest runway width expressed in meters with precision up to two decimal positions. Defaults to null when this information is not available.

openingIndicator

String

Opening indicator flag taking into consideration the 4 types of airport availability. For details see opening indicator section. Available values: OPEN, SEE_TIMES, CLOSED, UNKNOWN Defaults to null when this information is not available.

distanceFromSearchCoordinates

Decimal

Distance from the search coordinates given in the query expressed in kilometers with precision up to two decimal positions. Defaults to null when no search coordinates were given in the query.

operationalStatus

String

Worst criticality of the valid operational notes for the airport. Available values: INFORMATION_ONLY, OPERATIONALLY_RELEVANT, OPERATIONALLY_CRITICAL Defaults to null when no operational notes are present for the airport.

Last updated