API reference / Reference

get/v1/airports/{iata}

Fetch one airport by IATA code

Operation
getAirport
Authentication
API key

404s for an unknown code rather than returning an empty list.

Request

Parameters

iatapathrequiredstring

Responses

200The airport.
iata_codestringnullrequired

example: NBO

icao_codestringnullrequired
namestringrequired
municipalitystringrequired

City or town. Empty where the source has none.

country_iso2stringrequired

Where the airport is, not where the traveller is from.

typestringrequired

`large_airport` | `medium_airport` | `small_airport` | `heliport` | `closed` …

example: large_airport

scheduled_servicebooleanrequired

Airlines run scheduled service here. The filter that makes a picker usable.

latitudenumbernullrequired
longitudenumbernullrequired
400The request body or query failed validation.
errorobjectrequired
401No key, an unknown key, a revoked key, or a key whose tenant is not active. All four return an identical body on purpose: distinguishing them would let a caller discover which partners we have.
errorobjectrequired
403The key is valid but does not hold the scope this route requires.
errorobjectrequired
404Not found, or not yours. A resource belonging to another tenant answers 404 rather than 403, because 403 would confirm the record exists.
errorobjectrequired

Example

curl
curl -X GET https://api.haavisa.com/v1/airports/<iata> \
  -H "Authorization: Bearer $HAAVISA_API_KEY"

More in Reference

Something unclear? The eligibility guide explains the model behind the answers; the errors guide covers the envelope.