Skip to main content
GET
/
data
/
airports
/
iata
/
{iata_code}
Get airport by IATA code
curl --request GET \
  --url https://api.staging.rovemiles.com/functions/v1/data/airports/iata/{iata_code} \
  --header 'Authorization: Bearer <token>'
{
  "id": "a1b2c3d4-e5f6-7890-abcd-1234567890ab",
  "name": "John F. Kennedy International Airport",
  "iso_country": "US",
  "iso_region": "US-NY",
  "continent": "NA",
  "municipality": "New York",
  "gps_code": "KJFK",
  "iata_code": "JFK",
  "country": "United States",
  "latitude": 40.6413,
  "longitude": -73.7781
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Add your API key to the Authorization header with this format: 'Bearer your_api_key_here'

Path Parameters

​
iata_code
string
required

IATA 3-letter code of the airport (e.g., JFK, LAX, LHR)

Pattern: ^[A-Z]{3}$

Response

Successfully retrieved airport details

​
id
string<uuid>
required

Unique identifier for the airport (UUID)

Example:

"a1b2c3d4-e5f6-7890-abcd-1234567890ab"

​
name
string
required

Full name of the airport

Example:

"John F. Kennedy International Airport"

​
iso_country
string
required

ISO 3166-1 alpha-2 country code

Pattern: ^[A-Z]{2}$
Example:

"US"

​
iata_code
string
required

IATA 3-letter code for the airport

Pattern: ^[A-Z]{3}$
Example:

"JFK"

​
iso_region
string

ISO region code (typically ISO 3166-2 subdivision)

Example:

"US-NY"

​
continent
enum<string> | null

Continent code (NA, SA, EU, AS, AF, OC, AN)

Available options:
NA,
SA,
EU,
AS,
AF,
OC,
AN,
null
Example:

"NA"

​
municipality
string

Municipality (city) where the airport is located

Example:

"New York"

​
gps_code
string

GPS code or other global identifier

Example:

"KJFK"

​
country
string

Full country name

Example:

"United States"

​
latitude
number<double>

Airport latitude coordinate

Example:

40.6413

​
longitude
number<double>

Airport longitude coordinate

Example:

-73.7781