NOTAMs Active endpoint

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 ).

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

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

excluded_classificationsany ofOptional

Classifications to exclude: DOM, FDC, INTL, MIL. When empty, no classifications are excluded.

or

nullOptional

notam_idsstring[]Optional

List of NOTAM IDs

starts_atany ofOptional

Start date for the time period (YYYY-MM-DDTHH:MM:SSZ). When not provided, default to current UTC time.

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). When not provided, default to 365 days from starts_at.

Example: 2024-01-01T00:00:00Z

string · date-timeOptional

or

nullOptional

always_include_estany ofOptional

Whether to always include EST times in the window, even if the notam already expired.

Default: true

booleanOptional

or

nullOptional

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 or 3-character domestic airport codes. Maximum 5 locations. Can be provided as location.

Example: KJFK

qcodeany ofOptional

Filter by Q-code(s) (e.g., QMRLC, QWULW). Returns only NOTAMs with matching Q-codes.

string[]Optional

or

nullOptional

categoryany ofOptional

Filter by interpretation category(ies). Valid values: ALL, AERODROME, AIRSPACE, NAVIGATION, COMMUNICATION, OPERATIONS, OBSTACLES, ADMINISTRATIVE, WEATHER, SAFETY, OTHER. When 'ALL' is provided, no category filtering is applied. Note: Filtering happens after interpretation; total_count reflects pre-filter count and results may be fewer than per_page.

string[]Optional

or

nullOptional

subcategoryany ofOptional

Filter by interpretation subcategory(ies). Returns only NOTAMs with matching subcategories. Note: Filtering happens after interpretation; total_count reflects pre-filter count and results may be fewer than per_page.

string[]Optional

or

nullOptional

affected_elementany ofOptional

Filter by affected element effect and/or type. Format: 'effect:closed,type:runway' or 'closed runway' or 'closed' or 'runway'. Valid effects: CLOSED, RESTRICTED, HAZARD, UNSERVICEABLE, WORK_IN_PROGRESS, CAUTION. Valid types: AERODROME, RUNWAY, TAXIWAY, APPROACH, NAVAID, AIRSPACE, APRON, LIGHTING, SERVICE, PROCEDURE, OTHER. Note: Filtering happens after interpretation; total_count reflects pre-filter count and results may be fewer than per_page.

AffectedElementFilter[]Optional

or

nullOptional

Responses

200

Success

application/json

total_countintegerRequired

pageintegerRequired

per_pageintegerRequired

get

/notams

HTTPcURLJavaScriptPython

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: [phone].\nF) GND G) 1000FT AMSL",
      "qcode": "QWOLW",
      "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: [phone].\nF) GND G) 1000FT AMSL",
      "notam_number": "A0681/25",
      "starts_at": "2025-04-04T18:00:00Z"
    }
  ]
}