Introduction

NOTAMs (Notices to Airmen) are essential flight briefing information and can contain various import pieces of information affecting a flight. Retrieving an up-to-date and accurate NOTAM briefing is a prerequisite for flight planning.

autorouter hosts the complete database of NOTAMs, originated by Eurocontrol EAD through its INO (International NOTAM Operations) system. NOTAMs are updated immediately as their status changes (unless there is a system malfunction).

It is a little known fact, that while NOTAMs are an international aviation standard and available through many sources, the only authoritative and trustworthy source of European NOTAMs is Eurocontrol EAD and connected entities (such as autorouter). This is due to the fact that not all NOTAMs are marked for international dissemination and therefore not exchanged among the different members of the network. Take for example the public airport of Stuttgart Germany (EDDS) which is both a civil airport and a US military airport. If you query applicable NOTAMs through Eurocontrol EAD (say using autorouter), you will get different output than when you perform the same query using e.g. the popular FAA NOTAM query.

Search for NOTAMs

This API allows you to search for NOTAMs based on their itema member, i.e. the ICAO airport or FIR identifier it applies to.

HTTP GET to https://api.autorouter.aero/v1.0/notam?itemas=["EDDS"]&offset=0&limit=10

• itemas
  A JSON encoded list of item A identifiers (shown without URL component encoding in the above example).
• offset
  The result offset, 0 is the first. Default is 0.
• limit
  The number of rows to return, maximum is 100. Default is 100.
• startvalidity
  The validity start period in seconds since the Unix epoch. Default is 0.
• endvalidity
  The validity end period in seconds since the Unix epoch. Default is 2^32-1.

As result, you get a JSON structure with the matching NOTAMs.

{
   "total": 18,
   "rows": [
      {
         "code23": "FA",
         "code45": "LT",
         "endvalidity": 1493596740,
         "estimation": null,
         "fir": "EDGG",
         /* autorouter's internal ID */
         "id": 1499589,
         "itema": [
            "EDDS"
         ],
         "itemd": null,
         "iteme": "MIL SIDE NO TRANSIENT ALERT AVBL DLY 2000-0400, EXCEPT SELECTED
FLIGHTS.",
         "itemf": null,
         "itemg": null,
         /* Garmin format: * 90 / (1 << 30) to convert */
         "lat": 580814790,
         "lon": 109959116,
         "lower": 0,
         "modified": 1485763803,
         /* Garmin format */
         "nelat": 581807214,
         "nelon": 111462287,
         "nof": "ETCZ",
         "number": 825,
         "purpose: "NBO ",
         "radius": 5,
         "referrednumber": 7633,
         "referredseries": "P",
         "referredyear": 16,
         "scope": "A  ",
         "series": "P",
         "startvalidity": 1485763560,
         /* whether the user filtered this NOTAM from briefings */
         "suppressed": false,
         /* Garmin format */
         "swlat": 579822366,
         "swlon": 108455945,
         "traffic": "IV",
         "type": "R",
         "upper": 999,
         "year": 17
      }
      ...
   ]
}

The above example NOTAM would look as follows when formatted through a user interface.

P0825/17 NOTAM 
Q) EDGG/FALT/IV/NBO / A /000/999/4840N00912E 
A) EDDS 
B) 2017-01-30 08:06 C) 2017-04-30 23:59 
E) MIL SIDE NO TRANSIENT ALERT AVBL DLY 2000-0400, EXCEPT SELECTED 
FLIGHTS.