For the complete documentation index, see llms.txt. This page is also available as Markdown.
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 ).
Semantics output is available as an additional feature. To request access, contact hello@notamify.com.
Limitations:
The endpoint accepts 5 ICAO codes per call.
The start date cannot be earlier than one day before current UTC datetime.
from datetime import datetime, timedeltafrom notamify_sdk import NotamifyClient, ActiveNotamsQueryclient =NotamifyClient(token="YOUR_API_KEY")query =ActiveNotamsQuery(location=["EDDM","EGLL","EPWA","LIRP"],starts_at=datetime.now(),ends_at=datetime.now()+ timedelta(days=1))# Auto-paginated iterationfor notam in client.notams.active(query):print(f"{notam.notam_number} [{notam.icao_code}]: {notam.interpretation.excerpt}")
get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
notam_idsstring[]Optional
List of NOTAM IDs
starts_atstring · date-time · nullableOptional
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
ends_atstring · date-time · nullableOptional
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
always_include_estboolean · nullableOptional
Whether to always include EST times in the window, even if the notam already expired.
Default: true
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
qcodestring[] · nullableOptional
Filter by Q-code(s) (e.g., QMRLC, QWULW). Returns only NOTAMs with matching Q-codes.
categorystring[] · nullableOptional
Filter by category. Valid values: ALL, AERODROME, AIRSPACE, NAVIGATION, COMMUNICATION, OPERATIONS, OBSTACLES, ADMINISTRATIVE, WEATHER, SAFETY, OTHER. When 'ALL' is provided, no category filtering is applied. Filtered results may be fewer than per_page; total_count reflects the unfiltered match count.
subcategorystring[] · nullableOptional
Filter by subcategory. Returns only NOTAMs with matching subcategories. Filtered results may be fewer than per_page; total_count reflects the unfiltered match count.