Skip to content

Latest commit

 

History

History
1312 lines (978 loc) · 46 KB

README.md

File metadata and controls

1312 lines (978 loc) · 46 KB

Flight Data

This is an API to get data for the airports, runways, METARs and etc.

Base URL: https://api.airportweather.org/v1

METAR

Get METAR using ICAO code

URL Parameters Description
icao A single or multiple ICAO codes (Max Number: 30)
URL Queries Description Default
decode return decoded METAR or raw text false 
GET /metar/get-metar/:icao

# Single ICAO
$ curl https://api.airportweather.org/v1/metar/get-metar/cywg

# Single ICAO decoded
$ curl https://api.airportweather.org/v1/metar/get-metar/cywg?decode=true

# Multiple ICAOs
$ curl https://api.airportweather.org/v1/metar/get-metar/cywg,klas,zspd

# Multiple ICAOs decoded
$ curl https://api.airportweather.org/v1/metar/get-metar/klax,cyvr,cyyz?decode=true

Get metar within radius by ICAO

URL Parameters Description
icao A single ICAO code
URL Queries Type Description Default
distance number The surrounding radius from the ICAO code 50
unit string mile, miles, mi, kilometer, kilometers, km, nauticalmile, nauticalmiles, nm mile
decode boolean return decoded METAR or raw text false 
GET /metar/get-metar/radius/:icao

# Get all METARs within 50 miles from CYWG
$ curl https://api.airportweather.org/v1/get-metar/radius/cywg?distance=50&unit=mile&decode=true

Get metar within radius by longtitude and latitude

URL Parameters Description
coordinates longtitude and latitude followed by comma
URL Queries Type Description Default
distance number The surrounding radius from the target coordinates 50
unit string mile, miles, mi, kilometer, kilometers, km, nauticalmile, nauticalmiles, nm mile
decode boolean return decoded METAR or raw text false 
GET /get-metar/radius/coordinates/:coordinates

# Get all METARs within 50 miles from -97.5 49.9
$ curl https://api.airportweather.org/v1/metar/get-metar/radius/coordinates/-97.5,49.9

Get nearest METAR by ICAO

URL Parameters Description
icao A single ICAO code
URL Queries Type Description Default
decode boolean return decoded METAR or raw text false 
GET /metar/get-metar/radius/nearest/:icao

# Get nearest METAR from KBOS
$ curl https://api.airportweather.org/v1/metar/get-metar/nearest/KBOS

Get nearest METAR by longtitude and latitude

URL Parameters Description
coordinates longtitude and latitude followed by comma
URL Queries Type Description Default
decode boolean return decoded METAR or raw text false 
GET /get-metar/radius/nearest/coordinates/:coordinates

# Get nearest METAR from -97.5 49.9
$ curl https://api.airportweather.org/v1/metar/get-metar/nearest/coordinates/-97.5,49.9

Get metar by airport name

URL Parameters Description
name Airport name
URL Queries Type Description Default
decode boolean return decoded METAR or raw text false 
GET /metar/get-metar/name/:name

# Get METAR for airport's name that includ 'winnipeg'
$ curl https://api.airportweather.org/v1/get-metar/name/winnipeg
# Get decoded METAR for aiport's name that include 'boston'
$ curl https://api.airportweather.org/vi/get-metar/name/boston?decode=true

Get metar by geneirc input

URL Parameters Description
data A generic serch input
URL Queries Type Description Default
decode boolean return decoded METAR or raw text false 
GET /metar/get-metar/generic/:data

# Get METAR for airport's name that includ 'winnipeg' and location in 'winnipeg'
$ curl https://api.airportweather.org/v1/metar/get-metar/generic/winnipeg
# Get decoded METAR for aiport's name that include 'new york' and location in 'new york'
$ curl https://api.airportweather.org/v1/metar/get-metar/generic/new york?decode=true

response

Single standard METAR

{
    "results": 1,
    "data":
      [
          "CYVR 090200Z 15006KT 20SM FEW100 FEW230 23/10 A2986 RMK AC1CI2 AC TR CONTRAILS SLP115 DENSITY ALT 1000FT",
      ],
}

Single decoded METAR

{
    "results": 1,
    "data":
      [
          {
              "icao": "CYVR",
              "raw_text": "CYVR 090200Z 15006KT 20SM FEW100 FEW230 23/10 A2986 RMK AC1CI2 AC TR CONTRAILS SLP115 DENSITY ALT 1000FT",
              "barometer":
                { "hg": "29.86", "hpa": "1011", "kpa": "101.12", "mb": "1011.10" },
              "wind":
                {
                    "degrees": 150,
                    "speed_kts": 6,
                    "speed_kph": 11,
                    "speed_mps": 3,
                    "speed_mph": 7,
                },
              "clouds":
                [
                    {
                        "code": "FEW",
                        "name": "few",
                        "density": "1/8 - 2/8",
                        "feet": 10000,
                        "base_feet_agl": 10000,
                        "base_meters_agl": 3048,
                    },
                    {
                        "code": "FEW",
                        "name": "few",
                        "density": "1/8 - 2/8",
                        "feet": 23000,
                        "base_feet_agl": 23000,
                        "base_meters_agl": 7010,
                    },
                ],
              "visibility": { "miles_float": 20, "meters_float": 32187 },
              "temperature": { "celsius": 23, "fahrenheit": "73" },
              "dewpoint": { "celsius": 10, "fahrenheit": "50" },
              "humidity": { "percent": 44 },
              "elevation": { "feet": 7, "meters": 2 },
              "flight_category": "VFR",
              "station":
                {
                    "location":
                      {
                          "continent": "NA",
                          "country": "CA",
                          "region": "CA-BC",
                          "city": "Vancouver",
                          "name": "Vancouver International Airport",
                          "geometry":
                            { "coordinates": [ -123.17, 49.17 ], "type": "Point" },
                      },
                },
          },
      ],
}

Multipe standard METARs

{
    "results": 3,
    "data":
      [
          "CYVR 092300Z 12009KT 10SM -RA SCT055 BKN070 OVC095 13/11 A3002 RMK SC3AC2AC3 SLP168",
          "KBOS 092254Z 11004KT 10SM -RA FEW037 SCT080 BKN095 BKN130 14/13 A2972 RMK AO2 RAB16 SLP062 P0002 T01440128",
          "CYWG 092300Z 36015G21KT 15SM FEW070 24/08 A2986 RMK FU2 SLP116 DENSITY ALT 2200FT",
      ],
}

Multiple decoded METARs

{
    "results": 3,
    "data":
      [
          {
              "icao": "CYVR",
              "raw_text": "CYVR 092300Z 12009KT 10SM -RA SCT055 BKN070 OVC095 13/11 A3002 RMK SC3AC2AC3 SLP168",
              "barometer":
                { "hg": "30.02", "hpa": "1017", "kpa": "101.66", "mb": "1016.50" },
              "wind":
                {
                    "degrees": 120,
                    "speed_kts": 9,
                    "speed_kph": 17,
                    "speed_mps": 5,
                    "speed_mph": 10,
                },
              "clouds":
                [
                    {
                        "code": "SCT",
                        "name": "scattered",
                        "density": "3/8 - 4/8",
                        "feet": 5500,
                        "base_feet_agl": 5500,
                        "base_meters_agl": 1676,
                    },
                    {
                        "code": "BKN",
                        "name": "broken",
                        "density": "5/8 – 7/8",
                        "feet": 7000,
                        "base_feet_agl": 7000,
                        "base_meters_agl": 2134,
                    },
                    {
                        "code": "OVC",
                        "name": "overcast",
                        "density": "8/8",
                        "feet": 9500,
                        "base_feet_agl": 9500,
                        "base_meters_agl": 2896,
                    },
                ],
              "conditions":
                { "0": { "code": "-RA", "text": "light intensity rain" } },
              "visibility": { "miles_float": 10, "meters_float": 16093 },
              "temperature": { "celsius": 13, "fahrenheit": "55" },
              "dewpoint": { "celsius": 11, "fahrenheit": "52" },
              "humidity": { "percent": 88 },
              "elevation": { "feet": 7, "meters": 2 },
              "flight_category": "VFR",
              "station":
                {
                    "location":
                      {
                          "continent": "NA",
                          "country": "CA",
                          "region": "CA-BC",
                          "city": "Vancouver",
                          "name": "Vancouver International Airport",
                          "geometry":
                            { "coordinates": [ -123.17, 49.17 ], "type": "Point" },
                      },
                },
          },
          {
              "icao": "KBOS",
              "raw_text": "KBOS 092254Z 11004KT 10SM -RA FEW037 SCT080 BKN095 BKN130 14/13 A2972 RMK AO2 RAB16 SLP062 P0002 T01440128",
              "barometer":
                { "hg": "29.72", "hpa": "1006", "kpa": "100.64", "mb": "1006.30" },
              "wind":
                {
                    "degrees": 110,
                    "speed_kts": 4,
                    "speed_kph": 7,
                    "speed_mps": 2,
                    "speed_mph": 5,
                },
              "clouds":
                [
                    {
                        "code": "FEW",
                        "name": "few",
                        "density": "1/8 - 2/8",
                        "feet": 3700,
                        "base_feet_agl": 3700,
                        "base_meters_agl": 1128,
                    },
                    {
                        "code": "SCT",
                        "name": "scattered",
                        "density": "3/8 - 4/8",
                        "feet": 8000,
                        "base_feet_agl": 8000,
                        "base_meters_agl": 2438,
                    },
                    {
                        "code": "BKN",
                        "name": "broken",
                        "density": "5/8 – 7/8",
                        "feet": 9500,
                        "base_feet_agl": 9500,
                        "base_meters_agl": 2896,
                    },
                    {
                        "code": "BKN",
                        "name": "broken",
                        "density": "5/8 – 7/8",
                        "feet": 13000,
                        "base_feet_agl": 13000,
                        "base_meters_agl": 3962,
                    },
                ],
              "conditions":
                { "0": { "code": "-RA", "text": "light intensity rain" } },
              "visibility": { "miles_float": 10, "meters_float": 16093 },
              "temperature": { "celsius": 14.4, "fahrenheit": "58" },
              "dewpoint": { "celsius": 12.8, "fahrenheit": "55" },
              "humidity": { "percent": 90 },
              "elevation": { "feet": 13, "meters": 4 },
              "flight_category": "VFR",
              "station":
                {
                    "location":
                      {
                          "continent": "NA",
                          "country": "US",
                          "region": "US-MA",
                          "city": "Boston",
                          "name": "General Edward Lawrence Logan International Airport",
                          "geometry": { "coordinates": [ -71.02, 42.37 ], "type": "Point" },
                      },
                },
          },
          {
              "icao": "CYWG",
              "raw_text": "CYWG 092300Z 36015G21KT 15SM FEW070 24/08 A2986 RMK FU2 SLP116 DENSITY ALT 2200FT",
              "barometer":
                { "hg": "29.86", "hpa": "1011", "kpa": "101.12", "mb": "1011.10" },
              "wind":
                {
                    "degrees": 360,
                    "speed_kts": 15,
                    "speed_kph": 28,
                    "speed_mps": 8,
                    "speed_mph": 17,
                    "gust_kts": 21,
                    "gust_mps": 11,
                    "gust_kph": 39,
                    "gust_mph": 24,
                },
              "clouds":
                [
                    {
                        "code": "FEW",
                        "name": "few",
                        "density": "1/8 - 2/8",
                        "feet": 7000,
                        "base_feet_agl": 7000,
                        "base_meters_agl": 2134,
                    },
                ],
              "conditions": { "0": { "code": "FU2", "text": " smoke" } },
              "visibility": { "miles_float": 15, "meters_float": 24140 },
              "temperature": { "celsius": 24, "fahrenheit": "75" },
              "dewpoint": { "celsius": 8, "fahrenheit": "46" },
              "humidity": { "percent": 36 },
              "elevation": { "feet": 781, "meters": 238 },
              "flight_category": "VFR",
              "station":
                {
                    "location":
                      {
                          "continent": "NA",
                          "country": "CA",
                          "region": "CA-MB",
                          "city": "Winnipeg",
                          "name": "Winnipeg / James Armstrong Richardson International Airport",
                          "geometry": { "coordinates": [ -97.23, 49.9 ], "type": "Point" },
                      },
                },
          },
      ],
}

TAF

Get TAF using ICAO code

URL Parameters Description
icao A single or multiple ICAO codes (Max Number: 3)
URL Queries Description Default
decode return decoded TAF or raw text false 
GET /taf/get-taf/:icao

# Get TAF for CYYZ
$ curl https://api.airportweather.org/v1/taf/get-taf/cyyz

# Get decoded TAF for ZSSS
$ curl https://api.airportweather.org/v1/taf/get-taf/zsss?decoded=true

Weather

Note:

  • All METARs that does not belong to Navdata are removed.
  • The data will be updated every 10 minutes.

Country Scope

Get METARs for country sorted by temperature

URL Parameters Description
country Two letters country code
URL Queries Description Default
decode return decoded METAR or raw text false
sort Sort the temperature, 1 for low to high 1
limit Number of returned METARs 10 
GET /weather/country-weather/temperature/:country

# Get METARs based on the temperature for Canada, sorted from high to low with 20 results and decoded
$ curl https://api.airportweather.org/v1/weather/country-weather/temperature/ca?sort=-1&limit=20&decode=true

# Get METARs based on the temperature for UK, sorted from low to high with 10 results and returned as raw METAR
$ curl https://api.airportweather.org/v1/weather/country-weather/temperature/gb

Get METARs for country sorted by visibility

URL Parameters Description
country Two letters country code
URL Queries Description Default
decode return decoded METAR or raw text false
sort Sort the visibility, 1 for low/bad visibility to good 1
limit Number of returned METARs 10 
GET /weather/country-weather/visibility/:country

# Get METARs based on the visibility for Canada, sorted from low to high with 20 results and decoded
$ curl https://api.airportweather.org/v1/weather/country-weather/temperature/ca?limit=20&decode=true

# Get METARs based on the visibility for China, sorted from low to high with 10 results and returned as raw METAR
$ curl https://api.airportweather.org/v1/weather/country-weather/visibility/cn

Get METARs for country sorted by barometer

URL Parameters Description
country Two letters country code
URL Queries Description Default
decode return decoded METAR or raw text false
sort Sort the barometer, 1 for low baromter to high 1
limit Number of returned METARs 10 
GET /weather/country-weather/baro/:country

# Get METARs based on the barometer for Canada, sorted from low to high with 20 results and decoded
$ curl https://api.airportweather.org/v1/weather/country-weather/baro/ca?limit=20&decode=true

# Get METARs based on the barometer for USA, sorted from high to low with 10 results and returned as raw METAR
$ curl https://api.airportweather.org/v1/weather/country-weather/baro/us&sort=-1

Get METARs for country sorted by wind gust speed

URL Parameters Description
country Two letters country code
URL Queries Description Default
decode return decoded METAR or raw text false
limit Number of returned METARs 10 
GET /weather/country-weather/wind-gust-speed/:country

# Get METARs based on the wind gust speed for Canada, sorted from high to low with 20 results and decoded
$ curl https://api.airportweather.org/v1/weather/country-weather/wind-gust-speed/ca?limit=20&decode=true

# Get METARs based on the wind gust speed for USA, sorted from high to low with 10 results and returned as raw METAR
$ curl https://api.airportweather.org/v1/weather/country-weather/wind-gust-speed/us

Get METARs for country sorted by wind gust speed

URL Parameters Description
country Two letters country code
URL Queries Description Default
decode return decoded METAR or raw text false
limit Number of returned METARs 10 
GET /weather/country-weather/wind-gust-speed/:country

# Get METARs based on the wind gust speed for Canada, sorted from high to low with 20 results and decoded
$ curl https://api.airportweather.org/v1/weather/country-weather/wind-gust-speed/ca?limit=20&decode=true

# Get METARs based on the wind gust speed for USA, sorted from high to low with 10 results and returned as raw METAR
$ curl https://api.airportweather.org/v1/weather/country-weather/wind-gust-speed/us

Get METARs for country sorted by wind speed

URL Parameters Description
country Two letters country code
URL Queries Description Default
decode return decoded METAR or raw text false
limit Number of returned METARs 10 
GET /weather/country-weather/wind-speed/:country

# Get METARs based on the wind speed for Canada, sorted from high to low with 20 results and decoded
$ curl https://api.airportweather.org/v1/weather/country-weather/wind-speed/ca?limit=20&decode=true

# Get METARs based on the wind speed for Germany, sorted from high to low with 10 results and returned as raw METAR
$ curl https://api.airportweather.org/v1/weather/country-weather/wind-speed/de

Continent Scope

Get METARs for continent sorted by temperature

URL Parameters Description
continent Two letters continent code
URL Queries Description Default
decode return decoded METAR or raw text false
sort Sort the temperature, 1 for low to high 1
limit Number of returned METARs 10 
GET /weather/continent-weather/temperature/:continent

# Get METARs based on the temperature for Asia, sorted from high to low with 20 results and decoded
$ curl https://api.airportweather.org/v1/weather/continent-weather/temperature/as?sort=-1&limit=20&decode=true

# Get METARs based on the temperature for Europe, sorted from low to high with 10 results and returned as raw METAR
$ curl https://api.airportweather.org/v1/weather/continent-weather/temperature/eu

Get METARs for continent sorted by visibility

URL Parameters Description
continent Two letters continent code
URL Queries Description Default
decode return decoded METAR or raw text false
sort Sort the visibility, 1 for low to high 1
limit Number of returned METARs 10 
GET /weather/continent-weather/temperature/:continent

# Get METARs based on the visibility for Asia, sorted from high to low with 20 results and decoded
$ curl https://api.airportweather.org/v1/weather/continent-weather/visibility/as?sort=-1&limit=20&decode=true

# Get METARs based on the visibility for North America, sorted from low to high with 10 results and returned as raw METAR
$ curl https://api.airportweather.org/v1/weather/continent-weather/visibility/na

Get METARs for continent sorted by barometer

URL Parameters Description
continent Two letters continent code
URL Queries Description Default
decode return decoded METAR or raw text false
sort Sort the borometer, 1 for low to high 1
limit Number of returned METARs 10 
GET /weather/continent-weather/baro/:continent

# Get METARs based on the barometer for Asia, sorted from high to low with 20 results and decoded
$ curl https://api.airportweather.org/v1/weather/continent-weather/baro/as?sort=-1&limit=20&decode=true

# Get METARs based on the barometer for North America, sorted from low to high with 10 results and returned as raw METAR
$ curl https://api.airportweather.org/v1/weather/continent-weather/baro/na

Get METARs for continent sorted by wind gust speed

URL Parameters Description
continent Two letters continent code
URL Queries Description Default
decode return decoded METAR or raw text false
limit Number of returned METARs 10 
GET /weather/continent-weather/wind-gust-speed/:continent

# Get METARs based on the wind gust speed for Asia, sorted from high to low with 20 results and decoded
$ curl https://api.airportweather.org/v1/weather/continent-weather/wind-gust-speed/as?limit=20&decode=true

# Get METARs based on the wind gust speed for Africa, sorted from high to low with 10 results and returned as raw METAR
$ curl https://api.airportweather.org/v1/weather/continent-weather/wind-gust-speed/af

Get METARs for continent sorted by wind speed

URL Parameters Description
continent Two letters continent code
URL Queries Description Default
decode return decoded METAR or raw text false
limit Number of returned METARs 10 
GET /weather/continent-weather/wind-speed/:country

# Get METARs based on the wind speed for Asia, sorted from high to low with 20 results and decoded
$ curl https://api.airportweather.org/v1/weather/continent-weather/wind-speed/as?limit=20&decode=true

# Get METARs based on the wind speed for Europe, sorted from high to low with 10 results and returned as raw METAR
$ curl https://api.airportweather.org/v1/weather/continent-weather/wind-speed/eu

Global Scope

Get METARs for global sorted by temperature

URL Queries Description Default
decode return decoded METAR or raw text false
sort Sort the temperature, 1 for low to high 1
limit Number of returned METARs 10 
GET /weather/global-weather/temperature

# Get METARs based on the temperature for global, sorted from high to low with 20 results and decoded
$ curl https://api.airportweather.org/v1/weather/global-weather/temperature?sort=-1&limit=20&decode=true

# Get METARs based on the temperature for Europe, sorted from low to high with 10 results and returned as raw METAR
$ curl https://api.airportweather.org/v1/weather/global-weather/temperature

Get METARs for global sorted by visibility

URL Queries Description Default
decode return decoded METAR or raw text false
sort Sort the visibility, 1 for low to high 1
limit Number of returned METARs 10 
GET /weather/global-weather/temperature

# Get METARs based on the visibility for global, sorted from high to low with 20 results and decoded
$ curl https://api.airportweather.org/v1/weather/global-weather/visibility?sort=-1&limit=20&decode=true

# Get METARs based on the visibility for global, sorted from low to high with 10 results and returned as raw METAR
$ curl https://api.airportweather.org/v1/weather/continent-weather/visibility

Get METARs for global sorted by barometer

URL Queries Description Default
decode return decoded METAR or raw text false
sort Sort the borometer, 1 for low to high 1
limit Number of returned METARs 10 
GET /weather/global-weather/baro/:continent

# Get METARs based on the barometer for global, sorted from high to low with 20 results and decoded
$ curl https://api.airportweather.org/v1/weather/global-weather/baro?sort=-1&limit=20&decode=true

# Get METARs based on the barometer for global, sorted from low to high with 10 results and returned as raw METAR
$ curl https://api.airportweather.org/v1/weather/global-weather/baro

Get METARs for global sorted by wind gust speed

URL Queries Description Default
decode return decoded METAR or raw text false
limit Number of returned METARs 10 
GET /weather/global-weather/wind-gust-speed

# Get METARs based on the wind gust speed for global, sorted from high to low with 20 results and decoded
$ curl https://api.airportweather.org/v1/weather/global-weather/wind-gust-speed?limit=20&decode=true

# Get METARs based on the wind gust speed for global, sorted from high to low with 10 results and returned as raw METAR
$ curl https://api.airportweather.org/v1/weather/global-weather/wind-gust-speed

Get METARs for global sorted by wind speed

URL Queries Description Default
decode return decoded METAR or raw text false
limit Number of returned METARs 10 
GET /weather/global-weather/wind-speed/:country

# Get METARs based on the wind speed for global, sorted from high to low with 20 results and decoded
$ curl https://api.airportweather.org/v1/weather/global-weather/wind-speed?limit=20&decode=true

# Get METARs based on the wind speed for global, sorted from high to low with 10 results and returned as raw METAR
$ curl https://api.airportweather.org/v1/weather/global-weather/wind-speed

METAR Search

Search METAR for ICAO code

URL Parameters Description
icao ICAO code
URL Queries Description Default
decode return decoded METAR or raw text false
limit Number of returned METARs 10 
GET /weather/search-weather/icao/:icao

# Get decoded METAR for CYWG
$ curl https://api.airportweather.org/v1/weather/search-weather/icao/cywg?decode=true

# Get raw METAR for KBOS
$ curl https://api.airportweather.org/v1/weather/search-weather/icao/kbos

Search METAR for IATA code

URL Parameters Description
iata IATA code
URL Queries Description Default
decode return decoded METAR or raw text false
limit Number of returned METARs 10 
GET /weather/search-weather/iata/:iata

# Get decoded METAR for CYWG
$ curl https://api.airportweather.org/v1/weather/search-weather/iata/ywg?decode=true

# Get raw METAR for KBOS
$ curl https://api.airportweather.org/v1/weather/search-weather/iata/bos

Search METAR for airport's name

URL Parameters Description
name Airport name
URL Queries Description Default
decode return decoded METAR or raw text false
limit Number of returned METARs 10 
GET /weather/search-weather/name/:name

# Get decoded METAR for airport's name that included "pudong"
$ curl https://api.airportweather.org/v1/weather/search-weather/name/pudong?decode=true

# Get raw METAR for airport's name that included boston
$ curl https://api.airportweather.org/v1/weather/search-weather/name/boston

Search METAR based on the generic input

URL Parameters Description
data Generic search query
URL Queries Description Default
decode return decoded METAR or raw text false
limit Number of returned METARs 10 
GET /weather/search-weather/generic/:data

# Get decoded METAR for airport's name, city or location that included "shanghai"
$ curl https://api.airportweather.org/v1/weather/search-weather/generic/shanghai?decode=true

# Get raw METAR for airport's name, city or location that included new york
$ curl https://api.airportweather.org/v1/weather/search-weather/name/new york

Airports

Get Airport data using ICAO

URL Parameters Description
icao ICAO code
URL Queries Description Default
decode return decoded METAR or raw text false 
GET /airports/icao/:icao

# Get airport with ICAO code, with METAR decoded
$ curl https://api.airportweather.org/v1/airports/icao/cyyz?decode=true

# Get airport with ICAO code, with raw METAR
$ curl https://api.airportweather.org/v1/airports/icao/ksan

Get Airport data using iata

URL Parameters Description
iata IATA code
URL Queries Description Default
decode return decoded METAR or raw text false 
GET /airports/iata/:iata

# Get airport with IATA code, with METAR decoded
$ curl https://api.airportweather.org/v1/airports/iata/ywg?decode=true

# Get airport with IATA code, with raw METAR
$ curl https://api.airportweather.org/v1/airports/iata/jfk

Get Airports using airport name

URL Parameters Description
name airport name
URL Queries Description Default
limitResults limit number of results 10 
GET /airports/name/:name

# Get airports with name included "Richardson"
$ curl https://api.airportweather.org/v1/airports/name/Richardon

Get Airports using airport name (Pagination)

URL Parameters Description
name airport name
URL Queries Description Default
limit number of airports per page 10
page page number 1 
GET /airports/name/paginate/:name

# Get airports with name included "James", 15 airports per page, at page 2
$ curl https://api.airportweather.org/v1/airports/name/paginate/james?limit=15&page=2

Get Airport data using region name

URL Parameters Description
region city or region name
URL Queries Description Default
limitResults limit number of results 10 
GET /airports/region/:name

# Get airports with city named winnipeg
$ curl https://api.airportweather.org/v1/airports/city/winnipeg

# Only return25 results
$ curl https://api.airportweather.org/v1/airports/city/boston?limitResults=2

# Get airports with region name, region name can be either province or state or state
$ curl https://api.airportweather.org/v1/airports/city/manitoba?limitResults=2
$ curl https://api.airportweather.org/v1/airports/city/california?limitResults=3

Get Airport data using region name (Pagination)

URL Parameters Description
region city or region name
URL Queries Description Default
limit number of airports per page 10
page page number 1 
GET /airports/region/paginate/:region

# Get airports in Boston region, number of airports per page: 15, on page number: 2
$ curl https://api.airportweather.org/v1/airports/region/paginate/boston?limit=15&page=2

Get Airport data using country name or country code

URL Parameters Description
country country name or country code
URL Queries Description Default
limitResults limit number of results 10 
GET /airports/country/:country

# Get airports with country code: ca
$ curl https://api.airportweather.org/v1/airports/country/ca?limitResults=2

# Get airport with country name: united states
curl https://api.airportweather.org/v1/airports/country/united states?limitResults=15

Get Airport data using country name or country code (Pagination)

URL Parameters Description
country country name or country code
URL Queries Description Default
limit number of items per page 10
page page number 1 
GET /airports/country/paginate/:country

# Get airports with country code: ca, 25 airports per page, on page 3
$ curl https://api.airportweather.org/v1/airports/country/paginate/ca?limit=25&page=3

Get Airport data using generic info (fuzzy search)

URL Parameters Description
data generic serach query
URL Queries Description Default
limitResults limit number of results 10 
GET /airports/generic/:data

# Get airports which includes "new york" text (this would return 68 results)
$ curl https://api.airportweather.org/v1/airports/generic/new york

# Only return 5 results
$ curl https://api.airportweather.org/v1/airports/generic/new york?limitResults=5

# Or only enter ICAO or IATA code
$ curl https://api.airportweather.org/v1/airports/generic/cywg
$ curl https://api.airportweather.org/v1/airports/generic/bos

# Or enter region name or city name
$ curl https://api.airportweather.org/v1/airports/generic/manitoba

# or enter country name
$ curl https://api.airportweather.org/v1/airports/generic/China

Get Airport data using generic info (fuzzy search & pagination)

URL Parameters Description
data generic serach query
URL Queries Description Default
limit number of items per page 10
page page number 1 
GET /airports/generic/paginate/:data

# Get airports located in New York, each page return 15 airports, current page: 1
$ curl https://api.airportweather.org/v1/airports/geneirc/paginate/new york?limit=15&page=1

Get Airport data within radius of ICAO

URL Parameters Description
icao ICAO code
distance distance of radius
unit km or nm
URL Queries Description Default
limitResults limit number of results 10 
GET /airports/airports-within/icao/:icao/distance/:distance/unit/:unit

Get distance from origin airport to destination airport

URL Parameters Description
origin origin airport ICAO code
destination destination airport ICAO code
unit km or nm 
GET /airports-distance/origin/:originICAO/destination/:destinationICAO/unit/:unit

Vatsim

Get current vatsim traffics (track included)

GET /vatsim/getTraffics

Get Current vatsim pilots

GET /vatsim/getPilots

Get current vatsim events

Only current in progress events will be returned

GET /vatsim/getCurrentEvents

Get sorted vatsim events

URL Queries Description Default
target Sort events time by either start time or end time start_time
sort sorting order, either descending or ascending 1 
GET /vatsim/getSortedEventsByDate

# Get sorted vatsim events by start time in descending order (most recent events first)
$ curl https://api.airportweather.org/v1/vatsim/getSortedEventsByDate?target=start_time&sort=1

References:

Credits