Lumo Airport API (1.0.0)

Download OpenAPI specification:Download

Lumo API Support: support@thinklumo.com License: Apache 2.0

Lumo's Airport API is a single source of airport-level foreacsts and real-time data, such as Lumo's predictions, weather forecasts, scheduled volume, etc. through a single call.

Authentication

ApiKeyAuth

An API key from lumo is required to authenticate. You can request an api key at https://www.thinklumo.com/api-key-request or ping us on the chat on the bottom right of your page. Place the key into the HTTP request header as x-api-key: <key>

Security scheme type:	API Key
header parameter name:	x-api-key

airports

Get real-time and forecasted data for an airport for the next 72 hours.

Use the server https://airport-api.thinklumo.com/ for these endpoints.

Retrieve predicted and realtime info for an airport for the next 72 hours

This endpoint retrieves real-time data as well as forecasts for a given airport code (3-letter IATA code) for the next 72 hours.

Authorizations:

ApiKeyAuth

query Parameters

airport

required

string (IataAirportCode)

Example: "BOS"

The three-letter IATA airport code

Responses

200

OK.

400

A 400 indicates a bad request, likley due to missing parameters.

403

The most common cause is a missing or bad API key.

404

The most common cause of 404s is that the airport wasn't found, likely because it was misspelled or you're using the ICAO code (API uses the 3-letter IATA code).

500

Unknown error - contact support@thinklumo.com if you see this error.

get /v1/hourly-predictions

Lumo Airport API

https://airport-api.thinklumo.com/v1/hourly-predictions

Response samples

application/json

Copy

Expand all Collapse all

{

"current_time": "2020-10-28T12:46:56Z",
"airport":
{
- "iata_code": "BOS",
- "icao_code": "KBOS",
- "name": "Boston Edward L Logan Intl Apt",
- "city": "Boston",
- "country_code": "US"
},
"metar":
{
- "station_id": "KBOS",
- "metar_type": "METAR",
- "raw_text": "KBOS 091154Z 24012KT 10SM FEW110 FEW250 09/M07 A3026 RMK AO2 SLP248 T00941072 10094 20056 53006",
- "maxT_c": 9.4,
- "minT_c": 9.4,
- "temp_c": 9.4,
- "longitude": -71.02,
- "latitude": 42.37,
- "dewpoint_c": -7.2,
- "altim_in_hg": 30.259842,
- "elevation_m": 6,
- "wind_speed_kt": 12,
- "flight_category": "VFR",
- "observation_time": "2020-03-09T11:54:00Z",
- "wind_dir_degrees": 240,
- "sea_level_pressure_mb": 1024.8,
- "visibility_statute_mi": 10,
- "three_hr_pressure_tendency_mb": 0.6,
- "sky_condition":
  [
  - {
    "sky_cover": "FEW",
    "cloud_base_ft_agl": 11000
    }
  ]
},
"travel_advisories":
[
- {
  - "issued_by": "Government of Canada",
  - "advisory": "Chile - Avoid non-essential travel",
  - "scope": "country",
  - "url": "http://travel.state.gov/content/travel/en/traveladvisories/traveladvisories/chile-travel-advisory.html",
  - "last_updated": "2020-01-29T06:00:00Z"
  }
],
"covid_stats":
{
- "country":
  {
  - "daily_data":
    {
    "report_date":
    [
    "2020-12-30"
    ],
    "new_cases":
    [
    123
    ],
    "new_deaths":
    [
    12
    ]
    },
  - "location_type": "country",
  - "location_code": "US",
  - "location_name": "United States",
  - "population": 123456,
  - "data_source": "https://ourworldindata.org/coronavirus-source-data",
  - "chart_url": "https://cdn.thinklumo.com/covid/US.png",
  - "risk_rating":
    {
    "current_to_last_ratio": 0.9435,
    "current_to_peak_ratio": 0.2345,
    "risk_index": 8,
    "risk_level": "low"
    }
  },
- "state_provice":
  {
  - "daily_data":
    {
    "report_date":
    [
    "2020-12-30"
    ],
    "new_cases":
    [
    123
    ],
    "new_deaths":
    [
    12
    ]
    },
  - "location_type": "country",
  - "location_code": "US",
  - "location_name": "United States",
  - "population": 123456,
  - "data_source": "https://ourworldindata.org/coronavirus-source-data",
  - "chart_url": "https://cdn.thinklumo.com/covid/US.png",
  - "risk_rating":
    {
    "current_to_last_ratio": 0.9435,
    "current_to_peak_ratio": 0.2345,
    "risk_index": 8,
    "risk_level": "low"
    }
  },
- "county_district":
  {
  - "daily_data":
    {
    "report_date":
    [
    "2020-12-30"
    ],
    "new_cases":
    [
    123
    ],
    "new_deaths":
    [
    12
    ]
    },
  - "location_type": "country",
  - "location_code": "US",
  - "location_name": "United States",
  - "population": 123456,
  - "data_source": "https://ourworldindata.org/coronavirus-source-data",
  - "chart_url": "https://cdn.thinklumo.com/covid/US.png",
  - "risk_rating":
    {
    "current_to_last_ratio": 0.9435,
    "current_to_peak_ratio": 0.2345,
    "risk_index": 8,
    "risk_level": "low"
    }
  }
},
"covid_info":
{
- "entry_exit_info":
  [
  - {
    "source": "http://link.to/url/",
    "testing": "Some testing requirements...",
    "quarantine": "Some quarantine requirements...",
    "travel_restrictions": "Some travel restrictions...",
    "last_updated": "2020-01-13T14:15:16",
    "location_code": "IN",
    "location_name": "India",
    "location_type": "country"
    }
  ]
},
"notam":
[
- {
  - "StateCode": "MYS",
  - "StateName": "Malaysia",
  - "id": "Aa1111/20",
  - "entity": "MX",
  - "status": "LC",
  - "Qcode": "MXLC",
  - "Area": "airport",
  - "SubArea": "Movement and landing area",
  - "Condition": "Limitations",
  - "Subject": "Taxiway(s)",
  - "Modifier": "Closed",
  - "message": "TWY S3 CLSD\\nCREATED: 09 Mar 2020 10:51:00 \\nSOURCE: WMKKYNYX",
  - "startdate": "2020-03-09T17:00:00.000Z",
  - "enddate": "2020-03-10T22:00:00.000Z",
  - "all": "A1111/20 NOTAMN\\nQ) WMFC/QMXLC/IV/M /A /000/999/0244N10141E005\\nA) WMKK B) 2003091700 C) 2003102200 \\nD) DLY BTN 1700-2200\\nE) TWY S3 CLSD\\nCREATED: 09 Mar 2020 10:51:00 \\nSOURCE: WMKKYNYX",
  - "location": "WMKK",
  - "isICAO": true,
  - "Created": "2020-03-09T10:51:00.000Z",
  - "key": "A1111/20-WMKK",
  - "type": "airport",
  - "criticality": -1
  }
],
"taf": "TAF WMKK 091100Z 0912/1018 01006KT 9999 FEW017CB TEMPO 0912/0915 4000 TSRA FEW010 FEW016CB SCT024 PROB30 TEMPO 1008/1012 23008G20KT 4000 TSRA FEW010 FEW016CB SCT018",
"faa_program_predictions":
[
- "Time: 09/1800-09/2059, Likelihood: PROBABLE, Rates: 38/38/38"
],
"hourly_data":
[
- {
  - "hour_utc": "2020-03-09T16:00:00",
  - "lumo_prediction":
    {
    "departures":
    {
    "num_flights_with_predictions": 10,
    "arrival_delay_distribution":
    [
    0.2608605352715315,
    0.4206262016745366,
    0.19464018963095767,
    0.059964125998917636,
    0.06390894742405655
    ],
    "avg_lumo_index": 1.123
    },
    "arrivals":
    {
    "num_flights_with_predictions": 10,
    "arrival_delay_distribution":
    [
    0.2608605352715315,
    0.4206262016745366,
    0.19464018963095767,
    0.059964125998917636,
    0.06390894742405655
    ],
    "avg_lumo_index": 1.123
    },
    "expected_arrivals": 0
    },
  - "scheduled":
    {
    "departures":
    {
    "num_flights": 10,
    "num_flights_no_data": 2,
    "delays":
    {
    "1": 20,
    "15": 15,
    "30": 9,
    "60": 4,
    "120": 3,
    "cnx": 2
    }
    },
    "arrivals":
    {
    "num_flights": 10,
    "num_flights_no_data": 2,
    "delays":
    {
    "1": 20,
    "15": 15,
    "30": 9,
    "60": 4,
    "120": 3,
    "cnx": 2
    }
    }
    },
  - "projected_demand":
    {
    "departures":
    {
    "gate": 10,
    "runway": 10
    },
    "arrivals":
    {
    "gate": 10,
    "runway": 10
    }
    },
  - "wx_forecast":
    {
    "temperature":
    {
    "recorded": 66.18,
    "apparent": 66.18
    },
    "cloud_cover": 0.17,
    "dew_point": 42.24,
    "humidity": 0.42,
    "description":
    {
    "summary": "Clear",
    "icon": "clear-day"
    },
    "ozone": 341.5,
    "precipitation":
    {
    "intensity": 0.3,
    "probability": 0.2
    },
    "pressure": 1019.8,
    "visibility": 10,
    "wind":
    {
    "speed": 6.61,
    "bearing": 47
    }
    },
  - "taf":
    [
    {
    "fcst_time_from": "2020-03-10T06:00:00Z",
    "fcst_time_to": "2020-03-10T06:00:00Z",
    "change_indicator": "BECMG",
    "time_becoming": "2020-03-10T06:00:00Z",
    "probability": 30,
    "wind_dir_degrees": 170,
    "wind_speed_kt": 15,
    "wind_gust_kt": 35,
    "wind_shear_hgt_ft_agl": 1500,
    "wind_shear_dir_degrees": 110,
    "wind_shear_speed_kt": 35,
    "visibility_statute_mi": 6.21,
    "altim_in_hg": 30.05906,
    "vert_vis_ft": 200,
    "wx_string": "SHRA",
    "not_decoded": "TX10/0915Z TN02/1006Z TX09/1015Z ",
    "sky_condition":
    [
    {
    "sky_cover": "FEW",
    "cloud_base_ft_agl": 11000
    }
    ],
    "turbulence_condition":
    [
    {
    "turbulence_intensity": 2,
    "turbulence_min_alt_ft_agl": 3000,
    "turbulence_max_alt_ft_agl": 11000
    }
    ],
    "icing_condition":
    [
    {
    "icing_intensity": 2,
    "icing_min_alt_ft_agl": 3000,
    "icing_max_alt_ft_agl": 11000
    }
    ]
    }
    ],
  - "faa_program_predicted":
    {
    "probability": 0.65,
    "impacting_condition": "weather / wind",
    "arrival_rate":
    [
    28,
    30,
    32
    ],
    "arrival_capacity":
    [
    28,
    30,
    32
    ],
    "program_rate":
    [
    28,
    30,
    32
    ]
    },
  - "faa_program_called":
    {
    "type": "GDP",
    "impacting_condition": "weather / wind",
    "start_utc": "2020-03-03T01:00:00Z",
    "end_utc": "2020-03-03T01:00:00Z",
    "issued_utc": "2020-03-03T01:00:00Z",
    "airport_scope": "",
    "carrier_scope": ""
    },
  - "special_alerts":
    [
    {
    "id": 123,
    "location":
    {
    "countries":
    [
    "US",
    "CA"
    ],
    "airports":
    [
    "BOS",
    "LGA"
    ]
    },
    "airline":
    {
    "carrier_codes":
    [
    "AA"
    ]
    },
    "period":
    {
    "start": "2020-01-29T06:00:00",
    "end": "2020-01-30T06:00:00",
    "tz": "local"
    },
    "operation":
    {
    "arrivals": true,
    "departures": false
    },
    "override_probs": false,
    "alert":
    {
    "type": "waiver",
    "summary": "United has issued travel waivers for Dec 11.",
    "description": "United has issued travel waivers for flights on Dec 11 due to forecast weather conditions.",
    "url": "https://www.thinklumo.com."
    },
    "send_alerts": "none",
    "date_restrictions":
    {
    "ticket_issued_on_before": "2020-01-29",
    "new_travel_begin": "2020-01-29",
    "new_travel_end": "2020-01-29"
    }
    }
    ]
  }
]

}