> For the complete documentation index, see [llms.txt](https://docs.aviowiki.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aviowiki.com/authenticated-endpoints/airport-endpoints/searching-airports.md).

# Searching airports

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

<mark style="color:blue;">`GET`</mark> `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    | <p>A comma-separated list of <a href="#undefined">airport</a> types to return. Possible options are <code>AIRPORT</code>, <code>HELIPORT</code>, <code>AIRSTRIP</code>, <code>WATER</code>.</p><p>If set it limits the returned locations to those with matching types in the <code>type</code> field.</p>                                                                                            |
| accepts             | List    | <p>A comma-separated list of the accepted types of traffic. Possible options are <code>SCHEDULED</code>, <code>NON\_SCHEDULED</code>, <code>GENERAL\_AVIATION</code>, <code>TRAINING</code>, <code>BUSINESS\_AVIATION</code>, <code>MILITARY</code>, <code>HELICOPTER</code>.</p><p>If set it limits the returned locations to those with matching types in the <code>accessibleFor</code> field.</p> |
| requiresPermission  | Boolean | <p>If set to <code>true</code>, returns locations that have any value in <code>nonScheduledPermission</code> except for <code>NONE</code> or <code>null</code>.</p><p>If set to <code>false</code>, returns location that have only <code>NONE</code> or <code>null</code> as <code>nonScheduledPermission</code>.</p>                                                                                |
| isVfr               | Boolean | <p>If set to <code>true</code>, returns locations that allow VFR traffic.</p><p>If set to <code>false</code>, returns locations that </p>                                                                                                                                                                                                                                                             |
| regions             | List    |                                                                                                                                                                                                                                                                                                                                                                                                       |
| country             | String  |                                                                                                                                                                                                                                                                                                                                                                                                       |
| countries           | List    |                                                                                                                                                                                                                                                                                                                                                                                                       |
| governingDistrict   | String  |                                                                                                                                                                                                                                                                                                                                                                                                       |
| minimumRunwayLength | Double  | <p>Minimum runway TORA the returned airports need to have. <br>If set, it limits the returned locations to those that have at least one runway with TORA at least <code>minimumRunwayLength</code>.</p>                                                                                                                                                                                               |
| maximumRunwayLength | Double  | <p>Maximum TORA the returned airports need to have. <br>If set, it limits the returned locations to those that's runways have TORA at most <code>maximumRunwayLength</code>.</p>                                                                                                                                                                                                                      |
| minimumRunwayWidth  | Double  | <p>Minimum runway width the returned airports need to have. <br>If set, it limits the returned locations to those that have at least one runway with width at least <code>minimumRunwayWidth</code>.</p>                                                                                                                                                                                              |
| maximumElevation    | Double  | <p>Maximum elevation the returned airports need to have.<br>If set, it limits the returned locations to those that have elevation at most <code>maximumElevation</code>.</p>                                                                                                                                                                                                                          |
| 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<mark style="color:red;">\*</mark> | String | An API Token using Bearer authorization. |

{% tabs %}
{% tab title="200: OK Paginated airport list" %}
Detailed properties of the pagination can be found at [Pagination](/conventions/pagination.md).&#x20;

Properties of the contained airports:

{% tabs %}
{% tab title="Response properties" %}

{% endtab %}

{% tab title="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
		}
	]
}
```

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="403: Forbidden No API token was provided or it was invalid." %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}

<table data-header-hidden><thead><tr><th width="228.87373263824156">Property</th><th width="150">Type</th><th>Description</th></tr></thead><tbody><tr><td>Property</td><td>Type</td><td>Description</td></tr><tr><td><code>aid</code></td><td>String</td><td><a href="/pages/-MSK0yT0xbFHC0I8opdb">Aviowiki ID</a> of the airport, with <code>APT</code> as namespace</td></tr><tr><td><code>name</code></td><td>String</td><td>The name of the airport. This should be the official name of the airport written in Latin characters.</td></tr><tr><td><code>country</code></td><td><a href="/pages/-MUP3Jkil0DeGQKvY9rY">Country</a></td><td>A <a href="/pages/-MUP3Jkil0DeGQKvY9rY">Country</a> object which represents the country at which an airport is located.</td></tr><tr><td><code>timeZone</code></td><td>String</td><td>The time-zone of the airfield as noted in the <a href="https://en.wikipedia.org/wiki/Tz_database">IANA Time Zone Database</a>.<br>Defaults to <code>null</code> when this information is not available.</td></tr><tr><td><code>coordinates</code></td><td><a href="/pages/-MUP3HHnqurT_QdZAc3T">Coordinates</a></td><td> <a href="/pages/-MUP3HHnqurT_QdZAc3T">Coordinates</a> object which represents the location of the <a href="https://en.wikipedia.org/wiki/Airport_reference_point">Aerodrome Reference Point</a>.<br>Defaults to <code>null</code> if the information is not known.</td></tr><tr><td><code>icao</code></td><td>String</td><td>A string with the 4-letters ICAO code of the airport, or <code>null</code> if none is assigned</td></tr><tr><td><code>iata</code></td><td>String</td><td>A string with the 3-letters IATA code of the airport, or <code>null</code> if none is assigned.</td></tr><tr><td><code>localIdentifier</code></td><td>String</td><td>An identifier issued by the local authority, which is not recognised as an official ICAO or IATA code.<br>The name of the code for each country can be found in <code>Country.localIdentifierName</code></td></tr><tr><td><code>servedCityGoverningDistrict</code></td><td><a href="/pages/-MUP3MbAxRd8xQy0tsME">Governing District</a></td><td><p>A <a href="/pages/-MUP3MbAxRd8xQy0tsME">Governing District</a> object indicating the Governing District of the <code>servedCity</code>.</p><p></p><p>Defaults to <code>null</code> when the information is not known.</p></td></tr><tr><td><code>servedCity</code></td><td>String</td><td><p>A string containing the name of the city served by the airport.</p><p><br>Defaults to <code>null</code> when the information is not known.</p></td></tr><tr><td><code>elevation</code></td><td>Decimal</td><td>A decimal number representing the elevation of the airport expressed in meters. Two decimal positions are provided, for precise conversion to feet.<br><br>Defaults to <code>null</code> when the information is not known.</td></tr><tr><td><code>longestRunwayLength</code></td><td>Decimal</td><td>Longest runway length expressed in meters with precision up to two decimal positions.<br><br>Defaults to <code>null</code> when this information is not available.</td></tr><tr><td><code>widestRunwayWidth</code></td><td>Decimal</td><td>The widest runway width expressed in meters with precision up to two decimal positions.<br><br>Defaults to <code>null</code> when this information is not available.</td></tr><tr><td><code>openingIndicator</code></td><td>String</td><td>Opening indicator flag taking into consideration the 4 types of airport availability. For details see <a href="/pages/-MUP3E2gh6HIUla58k7Q#the-openingindicator-flag">opening indicator</a> section.<br>Available values: <code>OPEN</code>, <code>SEE_TIMES</code>, <code>CLOSED</code>, <code>UNKNOWN</code><br><br>Defaults to <code>null</code> when this information is not available.</td></tr><tr><td><code>distanceFromSearchCoordinates</code></td><td>Decimal</td><td>Distance from the search coordinates given in the query expressed in kilometers with precision up to two decimal positions.<br><br>Defaults to <code>null</code> when no search coordinates were given in the query.</td></tr><tr><td><code>operationalStatus</code></td><td>String</td><td>Worst criticality of the valid <a href="/pages/-MUP3f-B0M6hQRc-XTlO">operational notes</a> for the airport. Available values: <br><code>INFORMATION_ONLY</code>, <code>OPERATIONALLY_RELEVANT</code><em>,</em> <code>OPERATIONALLY_CRITICAL</code><br><br>Defaults to <code>null</code> when no operational notes are present for the airport.</td></tr></tbody></table>

## Retrieve random airports

<mark style="color:blue;">`GET`</mark> `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. |

{% tabs %}
{% tab title="200: OK Paginated airport list" %}
{% tabs %}
{% tab title="Response properties" %}

{% endtab %}

{% tab title="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
		}
	]
}
```

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="403: Forbidden No API token was provided or it was invalid." %}

{% endtab %}
{% endtabs %}

<table data-header-hidden><thead><tr><th width="228.87373263824156">Property</th><th width="150">Type</th><th>Description</th></tr></thead><tbody><tr><td>Property</td><td>Type</td><td>Description</td></tr><tr><td><code>name</code></td><td>String</td><td>The name of the airport. This should be the official name of the airport written in Latin characters.</td></tr><tr><td><code>country</code></td><td><a href="/pages/-MUP3Jkil0DeGQKvY9rY">Country</a></td><td>A <a href="/pages/-MUP3Jkil0DeGQKvY9rY">Country</a> object which represents the country at which an airport is located.</td></tr><tr><td><code>timeZone</code></td><td>String</td><td>The time-zone of the airfield as noted in the <a href="https://en.wikipedia.org/wiki/Tz_database">IANA Time Zone Database</a>.<br>Defaults to <code>null</code> when this information is not available.</td></tr><tr><td><code>aid</code></td><td>String</td><td><a href="/pages/-MSK0yT0xbFHC0I8opdb">Aviowiki ID</a> of the airport, with <code>APT</code> as namespace</td></tr><tr><td><code>coordinates</code></td><td><a href="/pages/-MUP3HHnqurT_QdZAc3T">Coordinates</a></td><td> <a href="/pages/-MUP3HHnqurT_QdZAc3T">Coordinates</a> object which represents the location of the <a href="https://en.wikipedia.org/wiki/Airport_reference_point">Aerodrome Reference Point</a>.<br>Defaults to <code>null</code> if the information is not known.</td></tr><tr><td><code>icao</code></td><td>String</td><td>A string with the 4-letters ICAO code of the airport, or <code>null</code> if none is assigned</td></tr><tr><td><code>iata</code></td><td>String</td><td>A string with the 3-letters IATA code of the airport, or <code>null</code> if none is assigned.</td></tr><tr><td><code>localIdentifier</code></td><td>String</td><td>An identifier issued by the local authority, which is not recognised as an official ICAO or IATA code.<br>The name of the code for each country can be found in <code>Country.localIdentifierName</code></td></tr><tr><td><code>servedCityGoverningDistrict</code></td><td><a href="/pages/-MUP3MbAxRd8xQy0tsME">Governing District</a></td><td><p>A <a href="/pages/-MUP3MbAxRd8xQy0tsME">Governing District</a> object indicating the Governing District of the <code>servedCity</code>.</p><p></p><p>Defaults to <code>null</code> when the information is not known.</p></td></tr><tr><td><code>servedCity</code></td><td>String</td><td><p>A string containing the name of the city served by the airport.</p><p><br>Defaults to <code>null</code> when the information is not known.</p></td></tr><tr><td><code>elevation</code></td><td>Decimal</td><td>A decimal number representing the elevation of the airport expressed in meters. Two decimal positions are provided, for precise conversion to feet.<br><br>Defaults to <code>null</code> when the information is not known.</td></tr><tr><td><code>longestRunwayLength</code></td><td>Decimal</td><td>Longest runway length expressed in meters with precision up to two decimal positions.<br><br>Defaults to <code>null</code> when this information is not available.</td></tr><tr><td><code>widestRunwayWidth</code></td><td>Decimal</td><td>The widest runway width expressed in meters with precision up to two decimal positions.<br><br>Defaults to <code>null</code> when this information is not available.</td></tr><tr><td><code>openingIndicator</code></td><td>String</td><td>Opening indicator flag taking into consideration the 4 types of airport availability. For details see <a href="/pages/-MUP3E2gh6HIUla58k7Q#the-openingindicator-flag">opening indicator</a> section.<br>Available values: <code>OPEN</code>, <code>SEE_TIMES</code>, <code>CLOSED</code>, <code>UNKNOWN</code><br><br>Defaults to <code>null</code> when this information is not available.</td></tr><tr><td><code>distanceFromSearchCoordinates</code></td><td>Decimal</td><td>Distance from the search coordinates given in the query expressed in kilometers with precision up to two decimal positions.<br><br>Defaults to <code>null</code> when no search coordinates were given in the query.</td></tr><tr><td><code>operationalStatus</code></td><td>String</td><td>Worst criticality of the valid <a href="/pages/-MUP3f-B0M6hQRc-XTlO">operational notes</a> for the airport. Available values: <br><code>INFORMATION_ONLY</code>, <code>OPERATIONALLY_RELEVANT</code><em>,</em> <code>OPERATIONALLY_CRITICAL</code><br><br>Defaults to <code>null</code> when no operational notes are present for the airport.</td></tr></tbody></table>