NOTAMs Raw endpoint

The following document contains details about RAW 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 ). The endpoint is created to prefetch the notams before pulling interpretations for verification purposes.

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

Example param setup in the URL:

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

Get active NOTAMs without interpretations

get

Returns raw NOTAMs without AI interpretations. Same query parameters and response shape as /notams, but each NOTAM has interpretation set to null. The endpoint purpose is verifying query and raw data before AI interpretation.

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/raw

HTTPcURLJavaScriptPython

GET /api/v2/notams/raw HTTP/1.1
Host: api.notamify.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Success

{
  "notams": [
    {
      "id": "7e1b2056-301d-4723-a7e8-d0994fb7d6b6",
      "notam_number": "A0681/25",
      "location": "EPWA",
      "icao_code": "EPWA",
      "starts_at": "2025-04-04T18:00:00Z",
      "ends_at": "2025-06-30T02:00:00Z",
      "issued_at": "2025-03-19T12:37:00Z",
      "is_estimated": false,
      "is_permanent": false,
      "message": "NAVIGATION WARNING...",
      "icao_message": "A0681/25 NOTAMN...",
      "qcode": "QWOLW",
      "interpretation": null
    }
  ],
  "total_count": 1,
  "page": 1,
  "per_page": 30
}