api.duoleads.com

{
  "properties": {
    "data": {
      "description": "found, matched_on (iata|icao), airport {iata, icao, name, municipality, country, region, lat, lon, elevation_ft (number|null, null when OurAirports has no elevation, 129 airports), type, timezone}, nearby (for near: the same plus distance_km and bearing_deg, nearest first; distance is haversine on a 6,371.0088 km sphere, bearing is the initial bearing in degrees from the query point; matched_on is absent). A code matches IATA (3 characters) first, then ICAO/local identifier. found is false for an unknown code or an empty nearby list. timezone is the IANA zone of the airport location, derived offline at build time from its coordinates (timezone-boundary-builder 2026d); it is the geographic zone, not an airline convention (Xinjiang airports read Asia/Urumqi, UTC+6, although flights run on Beijing time). Coordinates on a zone border can resolve to the neighbouring zone (Gold Coast OOL reads Australia/Sydney).",
      "properties": {
        "airport": {
          "properties": {
            "country": {
              "type": "string"
            },
            "elevation_ft": {
              "type": [
                "number",
                "null"
              ]
            },
            "iata": {
              "type": "string"
            },
            "icao": {
              "type": "string"
            },
            "lat": {
              "type": "number"
            },
            "lon": {
              "type": "number"
            },
            "municipality": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "region": {
              "type": "string"
            },
            "timezone": {
              "type": "string"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "iata",
            "icao",
            "name",
            "municipality",
            "country",
            "region",
            "lat",
            "lon",
            "elevation_ft",
            "type",
            "timezone"
          ],
          "type": "object"
        },
        "found": {
          "type": "boolean"
        },
        "matched_on": {
          "type": "string"
        },
        "nearby": {
          "items": {
            "properties": {
              "bearing_deg": {
                "type": "number"
              },
              "country": {
                "type": "string"
              },
              "distance_km": {
                "type": "number"
              },
              "elevation_ft": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "iata": {
                "type": "string"
              },
              "icao": {
                "type": "string"
              },
              "lat": {
                "type": "number"
              },
              "lon": {
                "type": "number"
              },
              "municipality": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "region": {
                "type": "string"
              },
              "timezone": {
                "type": "string"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "iata",
              "icao",
              "name",
              "municipality",
              "country",
              "region",
              "lat",
              "lon",
              "elevation_ft",
              "type",
              "timezone",
              "distance_km",
              "bearing_deg"
            ],
            "type": "object"
          },
          "type": "array"
        }
      },
      "required": [
        "found"
      ],
      "type": "object"
    },
    "meta": {
      "$ref": "#/components/schemas/Meta"
    },
    "ok": {
      "const": true
    },
    "route": {
      "const": "/v1/ref/airport"
    },
    "version": {
      "const": "1.0.0"
    }
  },
  "required": [
    "ok",
    "route",
    "version",
    "data",
    "meta"
  ],
  "type": "object"
}