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

Name	Type	Description
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

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

200: OK Paginated airport list

Detailed properties of the pagination can be found at Pagination.

Properties of the contained airports:

Response properties

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	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	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	Governing District	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.

Example response

{
	"page": {
		"number": 0,
		"size": 10,
		"totalPages": 1,
		"totalResults": 1
	},
	"content": [
		{
			"name": "John F. Kennedy International ",
			"country": {
				"iso2": "US",
				"iso3": "USA",
				"isoNumeric": 840,
				"name": "United States",
				"officialName": "United States of America",
				"localIdentifierName": null
			},
			"timeZone": "America/New_York",
			"aid": "APT-KS1J-8E0L",
			"coordinates": {
				"latitude": 40.6399278,
				"longitude": -73.7786944
			},
			"icao": "KJFK",
			"iata": "JFK",
			"localIdentifier": "JFK",
			"servedCityGoverningDistrict": {
				"code": "US-NY",
				"name": "New York",
				"administrativeType": "State"
			},
			"servedCity": "New York",
			"elevation": 3.96,
			"longestRunwayLength": 3800.25,
			"widestRunwayWidth": 60.96,
			"openingIndicator": "OPEN",
			"icon": "CIVIL",
			"distanceFromSearchCoordinates": null,
			"operationalStatus": null
		}
	]
}

403: Forbidden No API token was provided or it was invalid.

{
    // Response
}

Retrieve random airports

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

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

Headers

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

200: OK Paginated airport list

Response properties

Property	Type	Description
name	String	The name of the airport. This should be the official name of the airport written in Latin characters.
country	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	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	Governing District	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.

Example response

{
	"page": {
		"number": 0,
		"size": 1,
		"totalPages": 10000,
		"totalResults": 10000
	},
	"content": [
		{
			"name": "Rundu Airport",
			"country": {
				"iso2": "NA",
				"iso3": "NAM",
				"isoNumeric": 516,
				"name": "Namibia",
				"officialName": "Republic of Namibia",
				"localIdentifierName": null
			},
			"timeZone": "Africa/Windhoek",
			"aid": "APT-NYRI-716E",
			"coordinates": {
				"latitude": -17.9561111,
				"longitude": 19.7205556
			},
			"icao": "FYRU",
			"iata": "NDU",
			"localIdentifier": null,
			"servedCityGoverningDistrict": null,
			"servedCity": null,
			"aid": "APT-NYRI-716E",
			"elevation": 1106.0,
			"longestRunwayLength": 3354.0,
			"widestRunwayWidth": 30.0,
			"openingIndicator": "UNKNOWN",
			"icon": "OTHER",
			"distanceFromSearchCoordinates": null,
			"operationalStatus": null
		}
	]
}

403: Forbidden No API token was provided or it was invalid.