Notamify API
Notamify API v2
Notamify API v2
  • Welcome
  • Basics
    • Quick start
    • Authentication guide
    • Notamify API Credits
  • Notam Time Filtering
  • NOTAMs Archive endpoint (get-historical-notam)
  • NOTAMs Active endpoint (get-notams v2)
Powered by GitBook
On this page

NOTAMs Active endpoint (get-notams v2)

PreviousNOTAMs Archive endpoint (get-historical-notam)

Last updated 6 days ago

The following document contains details about NOTAMs active endpoint in version v2.

The output contains NOTAMs (and their interpretations) valid for a moment of query, filtered out to specific dates. The datetime filters (starts_at / ends_at) takes into consideration notam firm range, without using the timing section for the filtering (schedules ).

Please note that the endpoint is not yet fully supported for public use, and some features (like usage graph in API Portal) are still in progress.

Limitations:

  • The endpoint accepts 5 ICAO codes per call.

  • The start date cannot be earlier than one day before current UTC datetime.

  • ends_at must be later than starts_at

Read more about time filtering in Notam Time Filtering.

Example param setup in the URL:

https://api.notamify.com/api/v2/notams?location=EDDM&location=EGLL&starts_at=2025-05-06T00:00:00.000&ends_at=2025-05-06T23:59:00.000
get
Authorizations
Query parameters
pageintegerOptional

Page number to retrieve. Defaults to 1.

Default: 1
per_pageinteger · min: 1 · max: 30Optional

Number of NOTAMs per page. Defaults to 30.

Default: 30
locationstring[] · min: 1 · max: 5Optional

List of 4-character ICAO airport codes. Maximum 5 locations. Can be provided as location.

Example: KJFK
notam_idsstring[]Optional

List of NOTAM IDs

starts_atany ofOptional

Start date for the time period (YYYY-MM-DDTHH:MM:SSZ)

Example: 2024-01-01T00:00:00Z
string · date-timeOptional
or
nullOptional
ends_atany ofOptional

End date for the time period (YYYY-MM-DDTHH:MM:SSZ)

Example: 2024-01-01T00:00:00Z
string · date-timeOptional
or
nullOptional
Responses
200
Success
application/json
get
GET /api/v2/notams HTTP/1.1
Host: api.notamify.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

Success

{
  "notams": [
    {
      "ends_at": "2025-06-30T02:00:00Z",
      "icao_code": "EPWA",
      "icao_message": "A0681/25 NOTAMN\nQ) EPWW/QWOLW/IV/M  /AW/000/010/5213N02059E001\nA) EPWA B) 2504042000 C) 2506300400\nD) APR 04-06 11-13 18-20 25-27 2000-0400, MAY 02-04 09-11 16-18 \n23-25 30 2000-0400, MAY 31 2000-2359, JUN 01 0000-0400 2000-0400, \nJUN 06-08 13-15 20-22 27-29 2000-0400\nE) NAVIGATION WARNING.\nLASER AND REFLECTOR AT PSN: 521329N 0205928E - WARSZAWA.\nANGLE OF BEAM: 000-090 DEG.\nRANGE: 200M. \nCONTACT: +48 571 409 606.\nF) GND G) 1000FT AMSL",
      "id": "7e1b2056-301d-4723-a7e8-d0994fb7d6b6",
      "interpretation": {
        "affected_elements": [],
        "category": "NAVIGATION",
        "description": "A navigation warning is issued for a laser and reflector located at position 521329N 0205928E in Warszawa. The laser beam angle is from 000 to 090 degrees with a range of 200 meters. The warning is in effect during specified dates and times in April and May 2025.",
        "excerpt": "Navigation warning for a laser and reflector in Warszawa with specific operational times.",
        "map_elements": [
          {
            "area_number": null,
            "coordinates": [
              {
                "lat": 52.224722,
                "lon": 20.991111,
                "radius_nm": 0.11,
                "raw_radius": "200M",
                "raw_string": "521329N 0205928E"
              }
            ],
            "description": "Laser and reflector at position with a range of 200 meters.",
            "element_type": "circle",
            "geojson": {
              "geometry": {
                "coordinates": [
                  [
                    [
                      20.991111,
                      52.2265540978663
                    ],
                    [
                      20.991404155310587,
                      52.22654527581431
                    ],
                    [
                      20.991694487375277,
                      52.226518894619524
                    ],
                    [
                      20.991979200137575,
                      52.226475208347274
                    ],
                    [
                      20.992255551657944,
                      52.22641463772023
                    ],
                    [
                      20.99252088052017,
                      52.226337766066656
                    ],
                    [
                      20.99277263146227,
                      52.22624533370259
                    ],
                    [
                      20.993008379985046,
                      52.226138230802235
                    ],
                    [
                      20.993225855701354,
                      52.22601748882506
                    ],
                    [
                      20.99342296420116,
                      52.22588427058231
                    ],
                    [
                      20.99359780722186,
                      52.2257398590385
                    ],
                    [
                      20.993748700929586,
                      52.22558564495572
                    ],
                    [
                      20.993874192135447,
                      52.22542311349991
                    ],
                    [
                      20.99397307229053,
                      52.22525382993782
                    ],
                    [
                      20.994044389124884,
                      52.2250794245627
                    ],
                    [
                      20.994087455818416,
                      52.22490157699366
                    ],
                    [
                      20.994101857615316,
                      52.224722
                    ],
                    [
                      20.994087455818416,
                      52.22454242300634
                    ],
                    [
                      20.994044389124884,
                      52.2243645754373
                    ],
                    [
                      20.99397307229053,
                      52.22419017006218
                    ],
                    [
                      20.993874192135447,
                      52.22402088650009
                    ],
                    [
                      20.993748700929586,
                      52.22385835504428
                    ],
                    [
                      20.99359780722186,
                      52.2237041409615
                    ],
                    [
                      20.99342296420116,
                      52.22355972941769
                    ],
                    [
                      20.993225855701354,
                      52.22342651117494
                    ],
                    [
                      20.993008379985046,
                      52.223305769197765
                    ],
                    [
                      20.99277263146227,
                      52.22319866629741
                    ],
                    [
                      20.99252088052017,
                      52.22310623393334
                    ],
                    [
                      20.992255551657944,
                      52.22302936227977
                    ],
                    [
                      20.991979200137575,
                      52.222968791652725
                    ],
                    [
                      20.991694487375277,
                      52.222925105380476
                    ],
                    [
                      20.991404155310587,
                      52.22289872418569
                    ],
                    [
                      20.991111,
                      52.2228899021337
                    ],
                    [
                      20.990817844689413,
                      52.22289872418569
                    ],
                    [
                      20.990527512624723,
                      52.222925105380476
                    ],
                    [
                      20.990242799862425,
                      52.222968791652725
                    ],
                    [
                      20.989966448342056,
                      52.22302936227977
                    ],
                    [
                      20.98970111947983,
                      52.22310623393334
                    ],
                    [
                      20.98944936853773,
                      52.22319866629741
                    ],
                    [
                      20.989213620014954,
                      52.223305769197765
                    ],
                    [
                      20.988996144298646,
                      52.22342651117494
                    ],
                    [
                      20.98879903579884,
                      52.22355972941769
                    ],
                    [
                      20.98862419277814,
                      52.2237041409615
                    ],
                    [
                      20.988473299070414,
                      52.22385835504428
                    ],
                    [
                      20.988347807864553,
                      52.22402088650009
                    ],
                    [
                      20.98824892770947,
                      52.22419017006218
                    ],
                    [
                      20.988177610875116,
                      52.2243645754373
                    ],
                    [
                      20.988134544181584,
                      52.22454242300634
                    ],
                    [
                      20.988120142384684,
                      52.224722
                    ],
                    [
                      20.988134544181584,
                      52.22490157699366
                    ],
                    [
                      20.988177610875116,
                      52.2250794245627
                    ],
                    [
                      20.98824892770947,
                      52.22525382993782
                    ],
                    [
                      20.988347807864553,
                      52.22542311349991
                    ],
                    [
                      20.988473299070414,
                      52.22558564495572
                    ],
                    [
                      20.98862419277814,
                      52.2257398590385
                    ],
                    [
                      20.98879903579884,
                      52.22588427058231
                    ],
                    [
                      20.988996144298646,
                      52.22601748882506
                    ],
                    [
                      20.989213620014954,
                      52.226138230802235
                    ],
                    [
                      20.98944936853773,
                      52.22624533370259
                    ],
                    [
                      20.98970111947983,
                      52.226337766066656
                    ],
                    [
                      20.989966448342056,
                      52.22641463772023
                    ],
                    [
                      20.990242799862425,
                      52.226475208347274
                    ],
                    [
                      20.990527512624723,
                      52.226518894619524
                    ],
                    [
                      20.990817844689413,
                      52.22654527581431
                    ],
                    [
                      20.991111,
                      52.2265540978663
                    ]
                  ]
                ],
                "type": "Polygon"
              },
              "properties": {
                "element_type": "circle",
                "radius_nm": 0.11
              },
              "type": "Feature"
            }
          }
        ],
        "schedule_description": "On April 4-6, 11-13, 18-20, 25-27; May 2-4, 9-11, 16-18, 23-25, 30; May 31; June 1; June 6-8, 13-15, 20-22, 27-29 from 20:00 to 04:00.",
        "schedules": [
          {
            "description": "On April 4-6, 11-13, 18-20, 25-27 from 20:00 to 04:00.",
            "duration_hrs": 8,
            "is_sunrise_sunset": false,
            "rrule": "DTSTART:20250404T200000Z\nRRULE:FREQ=DAILY;UNTIL=20250627T040000Z;BYDAY=TH,FR,SA,SU,MO,TU,WE;COUNT=15",
            "source": "APR 04-06 11-13 18-20 25-27 2000-0400"
          },
          {
            "description": "On May 2-4, 9-11, 16-18, 23-25, 30 from 20:00 to 04:00.",
            "duration_hrs": 8,
            "is_sunrise_sunset": false,
            "rrule": "DTSTART:20250502T200000Z\nRRULE:FREQ=DAILY;UNTIL=20250530T040000Z;BYDAY=TH,FR,SA,SU,MO,TU,WE;COUNT=12",
            "source": "MAY 02-04 09-11 16-18 23-25 30 2000-0400"
          },
          {
            "description": "On May 31 from 20:00 to 23:59.",
            "duration_hrs": 4,
            "is_sunrise_sunset": false,
            "rrule": "DTSTART:20250531T200000Z\nRRULE:FREQ=DAILY;COUNT=1",
            "source": "MAY 31 2000-2359"
          },
          {
            "description": "On June 1 from 00:00 to 04:00 and 20:00 to 04:00.",
            "duration_hrs": 4,
            "is_sunrise_sunset": false,
            "rrule": "DTSTART:20250601T000000Z\nRRULE:FREQ=DAILY;COUNT=1",
            "source": "JUN 01 0000-0400 2000-0400"
          },
          {
            "description": "On June 6-8, 13-15, 20-22, 27-29 from 20:00 to 04:00.",
            "duration_hrs": 8,
            "is_sunrise_sunset": false,
            "rrule": "DTSTART:20250606T200000Z\nRRULE:FREQ=DAILY;UNTIL=20250629T040000Z;BYDAY=TH,FR,SA,SU,MO,TU,WE;COUNT=12",
            "source": "JUN 06-08 13-15 20-22 27-29 2000-0400"
          }
        ],
        "subcategory": "NAVIGATION_AID_STATUS"
      },
      "is_estimated": false,
      "is_permanent": false,
      "issued_at": "2025-03-19T12:37:00Z",
      "location": "EPWA",
      "message": "NAVIGATION WARNING.\nLASER AND REFLECTOR AT PSN: 521329N 0205928E - WARSZAWA.\nANGLE OF BEAM: 000-090 DEG.\nRANGE: 200M. \nCONTACT: +48 571 409 606.\nF) GND G) 1000FT AMSL",
      "notam_number": "A0681/25",
      "starts_at": "2025-04-04T18:00:00Z"
    }
  ]
}