docs — notams.coredoes.dev

notams.coredoes.dev — API reference

!! NOT FOR OPERATIONAL USE !! data may be stale, incomplete, or wrong

notams.coredoes.dev is a free feed of international NOTAMs from the ICAO distribution network, offered for noncommercial use.

the point of this project is to make NOTAM data accessible to people who don't want to deal with the red tape of getting access to government data feeds. i did that part for you and i'm redistributing the data for free, on the condition that your use of it is noncommercial.

new NOTAMs typically appear within ~30 seconds, but processing delays can stretch that to 5 minutes and some NOTAMs may be missed.

all read endpoints under /api/ require an api key, passed as the x-api-key header. api keys are free, just email notams@coredoes.dev.

webhook / direct push notification of new NOTAMs is also available on request. email notams@coredoes.dev if you'd like rows pushed to you instead of polling.

authentication:

curl -H "x-api-key: nta_..." https://notams.coredoes.dev/api/notams

endpoints:

GET  /api/health                          public  service + intake snapshot
GET  /api/notams                          keyed   list NOTAMs (filters below)
GET  /api/notams/:id                      keyed   one NOTAM by CADS id
GET  /api/notams/by-number/:notam_number  keyed   one NOTAM by ICAO number, e.g. A0906%2F26
GET  /api/notams.geojson                  keyed   FeatureCollection (same filters as /api/notams)

GET  /notams/:id                          public  HTML detail page
GET  /notams/:id/aixm.xml                 public  raw AIXM 5.1 XML
GET  /notams/:id/geojson                  public  GeoJSON Feature (rows with coordinates)

list filters (all optional, combinable):

location=KJFK   substring match against icao_location
status=NEW      one of NEW / REPLACE / CANCELLED
q=runway        substring match against the raw NOTAM text
limit=50        default 50, max 500
offset=0        for pagination

NotamDto fields:

id              i32      CADS NOTAM ID (stable, integer)
nms_id          string   CADS message ID
notam_number    string?  ICAO number, e.g. A0906/26
status          string?  NEW / REPLACE / CANCELLED
icao_location   string?  comma-joined ICAO location list
raw_text        string?  upstream NOTAM text
icao_text       string?  ICAO-formatted translation, HTML stripped
correlation_id  i64?     CADS sequence ID
latitude        f64?     decimal degrees
longitude       f64?     decimal degrees
radius_nm       f64?     affected radius, nautical miles
has_raw_xml     bool     true if /notams/:id/aixm.xml will return XML

caveats:

- Rebroadcast latency is normally ~30s but can stretch to several minutes.
- Some NOTAMs may be missed; gap detection triggers an automatic resync.
- Coordinates are parsed from the ICAO Q-line and may be absent or imprecise.
- This service is NOT for operational use under any circumstances.

!! NOT FOR OPERATIONAL USE !! data may be stale, incomplete, or wrong