aviowiki
  • Introduction
  • Authentication
    • Users
    • API Tokens
    • Authorisation
  • Conventions
    • Data format
    • aviowiki IDs
    • Pagination
  • Errors
  • Reward Points
  • Open Data
    • Introduction
    • Definition
  • Data Models
    • Airport
    • Authority
    • Availability
    • Aircraft Position
    • Coordinates
    • Region
    • Country
    • Governing District
    • Runway
    • Provider
    • Generic Product
    • Fuel Product
    • Fuel Fee
    • Webhook
    • Error
    • Operational Note
      • Airport Operational Note
      • Country Operational Note
  • Free Endpoints
    • Limitations
    • Free airport endpoints
      • Airport data
      • Searching airports
  • Authenticated Endpoints
    • Airport endpoints
      • Searching airports
      • Airport data
      • Authorities at an airport
      • Availability of an airport
        • Aerodrome Rescue and Fire Fighting availaibility
        • Air Traffic Control availability
        • Customs, Immigration and Quarantine facilities availability
        • Movement availability
      • Runways at an airport
      • Providers at an airport
      • Weather at an airport
      • Sun times at an airport
      • Operational notes at an airport
    • Aircraft endpoints
    • Aircraft position endpoints
    • Flight endpoints
    • Runway endpoints
      • Runway data
    • Provider endpoints
      • Provider data
      • Availability of a provider
      • Country of a provider
      • Pictures of a provider
      • Logo of a provider
      • Products of a provider
      • Fuel products of a provider
    • Operational Note endpoints
      • Operational Note data
    • Retrieve aircraft position
  • Release log
Powered by GitBook
On this page
  • Searching using a query
  • Search Airports using a text query
  • Format of the returned objects

Was this helpful?

  1. Free Endpoints
  2. Free airport endpoints

Searching airports

Searching using a query

Search Airports using a text query

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

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

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.

query

string

The query string you want to look for.

Headers

Name
Type
Description

Authorization

String

An API Token using Bearer authorization.

{
  "page": {
    "number": 0,
    "size": 10,
    "totalPages": 1,
    "totalResults": 2
  },
  "content": [
    {
      "country": {
        "iso2": "GB",
        "iso3": "GBR",
        "isoNumeric": 826,
        "name": "United Kingdom",
        "officialName": "United Kingdom of Great Britain and Northern Ireland"
      },
      "timeZone": "Europe/London",
      "aid": "APT-FO61-WBTO",
      "coordinates": {
        "latitude": 51.4775,
        "longitude": -0.4613889
      },
      "icao": "EGLL",
      "iata": "LHR",
      "faa": null,
      "servedCity": "London",
      "servedCityGoverningDistrict": null,
      "name": "Heathrow Airport"
    },
    {
      "country": {
        "iso2": "US",
        "iso3": "USA",
        "isoNumeric": 840,
        "name": "United States",
        "officialName": "United States of America"
      },
      "timeZone": "America/Chicago",
      "aid": "APT-PEKY-N349",
      "coordinates": {
        "latitude": 44.4641394,
        "longitude": -89.3587256
      },
      "icao": null,
      "iata": null,
      "faa": "WS14",
      "servedCity": "Amherst, WI",
      "servedCityGoverningDistrict": {
        "code": "US-WI",
        "name": "Wisconsin",
        "administrativeType": "State"
      },
      "name": "Lake Ell Field"
    }
  ]
}

Format of the returned objects

The response will be a Paged List of results. Each result object contains a limited set of information that we consider to be essential to identify a location.

For this endpoint the properties available in the response are:

Property

Type

Description

aid

string

A string with the AID of the airport, with APT as namespace

icao

string, null

iata

string, null

faa

string, null

coordinates

object, null

country

object, null

A Country object which represents the country at which an airport is located. null if this is not known.

timeZone

string, null

name

string, null

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

servedCity

string, null

A 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.

PreviousAirport dataNextAirport endpoints

Last updated 2 years ago

Was this helpful?

A string with the 4-letters of the airport, ornull if none is assigned

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

A string with the , or null if none is assigned.

A Coordinates object which represents the location of the . This is null when the information is not known.

The timezone of the airfield as noted in the . null indicates that this information is not available.

ICAO code
IATA code
FAA code
Aerodrome Reference Point
IANA Time Zone Database