GET /v1/aviation/countries

Countries that have airports, with the continents their airports are on and the number of airports in each. These are the values the countries filter accepts on an Airport field, and on each end of a Flight field.

Request

No body, no query parameters.

curl https://api.alchemy.example/v1/aviation/countries -H "X-Api-Key: YOUR_API_KEY"

Response

An array of { code, name, continents, airports, scheduledAirports }, ordered by name:

[
  { "code": "RU", "name": "Russia", "continents": ["AS", "EU"], "airports": 1800, "scheduledAirports": 150 },
  { "code": "GB", "name": "United Kingdom", "continents": ["EU"], "airports": 1600, "scheduledAirports": 55 }
]

The entries above are an example. Call the endpoint for current values.

Property	Description
code	The ISO 3166-1 alpha-2 code. This is the value the countries filter accepts.
name	The country's name.
continents	The continent codes of the country's airports. A country with airports on more than one continent lists each one. See Continents.
airports	The number of airports in the country, of every type.
scheduledAirports	The number of those airports with scheduled airline service.

airports includes heliports, small airfields and closed facilities. scheduledAirports is the number of airports a field with scheduledOnly set can return for the country.

Filtering with these values

A code from this list is the country of an entry in the countries property of an Airport field. Codes are matched without regard to case.

{
  "type": "Airport",
  "countries": [{ "country": "GB" }, { "country": "IE" }],
  "scheduledOnly": true,
  "map": { "iataCode": { "column": "code", "dataType": "Char" } }
}

To list the regions of a country, use GET /v1/aviation/regions. To list its airports, use GET /v1/aviation/airports.

Requires an API key (see Authentication) but is not billed.