Other endpoints

Get airport by IATA or ICAO code

GET

https://api.apicodex.io/aviation

/v1/airports/{code}

Look up a single airport by 3-letter IATA or 4-letter ICAO code, case-insensitive. 3-character codes resolve IATA first then ICAO; 4-character codes resolve ICAO first then IATA.

Get airport by IATA or ICAO code › path Parameters

code

string · pattern: ^[A-Za-z0-9]{3,4}$ · required

3-letter IATA or 4-letter ICAO airport code (case-insensitive).

Example: JFK

Get airport by IATA or ICAO code › Responses

Airport found.

Airport · required

Search airports

GET

https://api.apicodex.io/aviation

/v1/airports/search

Partial, case-insensitive search over airport name, city, IATA and ICAO, with optional exact-country and partial-city filters. At least one of q, country or city is required.

Search airports › query Parameters

q

string

Partial match against name / city / iata / icao (case-insensitive).

Example: kennedy

country

string

Exact ISO country code match (case-insensitive).

Example: US

city

string

Partial city match (case-insensitive).

Example: new york

limit

integer · min: 1 · max: 100

Maximum results to return. Default 20, max 100.

Default: 20

Search airports › Responses

Matching airports.

AirportSearchResult

count

integer · required

limit

integer · required

Airport[] · required

Nearest airports to a coordinate

GET

https://api.apicodex.io/aviation

/v1/airports/nearest

Returns airports nearest to a point, sorted ascending by great-circle (haversine) distance. Each result includes distance_km.

Nearest airports to a coordinate › query Parameters

lat

number · double · min: -90 · max: 90 · required

Latitude in decimal degrees (-90 to 90).

Example: 40.71

lon

number · double · min: -180 · max: 180 · required

Longitude in decimal degrees (-180 to 180).

Example: -74

limit

integer · min: 1 · max: 100

Maximum results to return. Default 20, max 100.

Default: 20

Nearest airports to a coordinate › Responses

Nearest airports.

NearestResult

count

integer · required

limit

integer · required

object · required

AirportWithDistance[] · required

GET/v1/airports/nearest

curl 'https://api.apicodex.io/aviation/v1/airports/nearest?lat=<number>&lon=<number>&apikey=<api-key>'

Example Responses

{
  "count": 2,
  "limit": 2,
  "origin": {
    "lat": 40.71,
    "lon": -74
  },
  "results": [
    {
      "icao": "06N7",
      "iata": "NYS",
      "name": "New York Skyports Seaplane Base",
      "city": "New York",
      "state": "New York",
      "country": "US",
      "lat": 40.734,
      "lon": -73.973,
      "elevation": 0,
      "tz": "America/New_York",
      "distance_km": 3.114
    },
    {
      "icao": "KJFK",
      "iata": "JFK",
      "name": "John F Kennedy International Airport",
      "city": "New York",
      "state": "New York",
      "country": "US",
      "lat": 40.639751,
      "lon": -73.778925,
      "elevation": 13,
      "tz": "America/New_York",
      "distance_km": 19.42
    }
  ]
}

json

application/json

Get airline by IATA or ICAO code

GET

https://api.apicodex.io/aviation

/v1/airlines/{code}

Look up a single airline by 2-letter IATA or 3-letter ICAO code, case-insensitive. 2-character codes resolve IATA first; 3-character codes resolve ICAO first, with a fallback to the source primary-key map.

Get airline by IATA or ICAO code › path Parameters

code

string · pattern: ^[A-Za-z0-9]{2,3}$ · required

2-letter IATA or 3-letter ICAO airline code (case-insensitive).

Example: AAL

Get airline by IATA or ICAO code › Responses

Airline found.

Airline · required

Search airlines

GET

https://api.apicodex.io/aviation

/v1/airlines/search

Partial, case-insensitive search over airline name, IATA, ICAO and callsign, with optional exact-country and active filters. At least one of q, country or active is required.

Search airlines › query Parameters

q

string

Partial match against name / iata / icao / callsign (case-insensitive).

Example: american

country

string

Exact country match (case-insensitive).

Example: United States

active

string · enum

Filter by active status. Accepts true/1 or false/0.

Enum values:

true

false

Example: true

limit

integer · min: 1 · max: 100

Maximum results to return. Default 20, max 100.

Default: 20

Search airlines › Responses

Matching airlines.

AirlineSearchResult

count

integer · required

limit

integer · required

Airline[] · required

Get airport by IATA or ICAO code

GET

https://api.apicodex.io/aviation

/v1/airports/{code}

Look up a single airport by 3-letter IATA or 4-letter ICAO code, case-insensitive. 3-character codes resolve IATA first then ICAO; 4-character codes resolve ICAO first then IATA.

Get airport by IATA or ICAO code › path Parameters

code

string · pattern: ^[A-Za-z0-9]{3,4}$ · required

3-letter IATA or 4-letter ICAO airport code (case-insensitive).

Example: JFK

Get airport by IATA or ICAO code › Responses

Airport found.

Airport · required

Search airports

GET

https://api.apicodex.io/aviation

/v1/airports/search

Partial, case-insensitive search over airport name, city, IATA and ICAO, with optional exact-country and partial-city filters. At least one of q, country or city is required.

Search airports › query Parameters

q

string

Partial match against name / city / iata / icao (case-insensitive).

Example: kennedy

country

string

Exact ISO country code match (case-insensitive).

Example: US

city

string

Partial city match (case-insensitive).

Example: new york

limit

integer · min: 1 · max: 100

Maximum results to return. Default 20, max 100.

Default: 20

Search airports › Responses

Matching airports.

AirportSearchResult

count

integer · required

limit

integer · required

Airport[] · required

Nearest airports to a coordinate

GET

https://api.apicodex.io/aviation

/v1/airports/nearest

Returns airports nearest to a point, sorted ascending by great-circle (haversine) distance. Each result includes distance_km.

Nearest airports to a coordinate › query Parameters

lat

number · double · min: -90 · max: 90 · required

Latitude in decimal degrees (-90 to 90).

Example: 40.71

lon

number · double · min: -180 · max: 180 · required

Longitude in decimal degrees (-180 to 180).

Example: -74

limit

integer · min: 1 · max: 100

Maximum results to return. Default 20, max 100.

Default: 20

Nearest airports to a coordinate › Responses

Nearest airports.

NearestResult

count

integer · required

limit

integer · required

object · required

AirportWithDistance[] · required

Get airline by IATA or ICAO code

GET

https://api.apicodex.io/aviation

/v1/airlines/{code}

Get airline by IATA or ICAO code › path Parameters

code

string · pattern: ^[A-Za-z0-9]{2,3}$ · required

2-letter IATA or 3-letter ICAO airline code (case-insensitive).

Example: AAL

Get airline by IATA or ICAO code › Responses

Airline found.

Airline · required

Search airlines

GET

https://api.apicodex.io/aviation

/v1/airlines/search

Partial, case-insensitive search over airline name, IATA, ICAO and callsign, with optional exact-country and active filters. At least one of q, country or active is required.

Search airlines › query Parameters

q

string

Partial match against name / iata / icao / callsign (case-insensitive).

Example: american

country

string

Exact country match (case-insensitive).

Example: United States

active

string · enum

Filter by active status. Accepts true/1 or false/0.

Enum values:

true

false

Example: true

limit

integer · min: 1 · max: 100

Maximum results to return. Default 20, max 100.

Default: 20

Search airlines › Responses

Matching airlines.

AirlineSearchResult

count

integer · required

limit

integer · required

Airline[] · required