GET/api/v1/notams/{icaoCodeOrIdent}Commercial Pilot

Get Notams For Airport

Gets all active NOTAMs for a specific airport.

Code Examples

curl \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://api.preflightapi.io/api/v1/notams/KJFK?classification=value&feature=value&freeText=value&effectiveStartDate=value&effectiveEndDate=value"

curl \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://api.preflightapi.io/api/v1/notams/KJFK?classification=value&feature=value&freeText=value&effectiveStartDate=value&effectiveEndDate=value"

Description

Returns NOTAMs matching the airport's FAA identifier or ICAO code. The identifier is case-insensitive — kdfw, KDFW, and DFW all match the same airport.

Optional Filters

All filter parameters are optional and can be combined to narrow results:

classification — NOTAM classification: INTERNATIONAL, MILITARY, LOCAL_MILITARY, DOMESTIC, FDC

feature — feature type: RWY, TWY, APRON, AD, OBST, NAV, COM, SVC, AIRSPACE, ODP, SID, STAR, CHART, DATA, DVA, IAP, VFP, ROUTE, SPECIAL, SECURITY

freeText — text search within NOTAM text (max 80 characters, alphanumeric and /.-( ) only)

effectiveStartDate / effectiveEndDate — ISO 8601 date range (must be paired)

Examples

GET /api/v1/notams/KDFW — all active NOTAMs for DFW
GET /api/v1/notams/DFW?classification=FDC — only FDC NOTAMs
GET /api/v1/notams/KDFW?feature=RWY — only runway-related NOTAMs
GET /api/v1/notams/KDFW?freeText=CLOSED — text search within NOTAM text
GET /api/v1/notams/KDFW?classification=DOMESTIC&feature=RWY — combined filters

Parameters

Name	In	Type	Description
icaoCodeOrIdent*	path	string	ICAO code (e.g., KDFW) or FAA identifier (e.g., DFW). Case-insensitive.
classification	query	string?	Optional NOTAM classification filter: INTERNATIONAL, MILITARY, LOCAL_MILITARY, DOMESTIC, FDC
feature	query	string?	Optional NOTAM feature type filter: RWY, TWY, APRON, AD, OBST, NAV, COM, SVC, AIRSPACE, ODP, SID, STAR, CHART, DATA, DVA, IAP, VFP, ROUTE, SPECIAL, SECURITY
freeText	query	string?	Optional text search within NOTAM text (max 80 characters, alphanumeric and /.-() only)
effectiveStartDate	query	string?	Optional effective start date filter (ISO 8601). Must be paired with effectiveEndDate.
effectiveEndDate	query	string?	Optional effective end date filter (ISO 8601). Must be paired with effectiveStartDate.

Response Schema

200Returns the NOTAMs for the airportNotamResponseDto

totalCountinteger

Total number of NOTAMs returned in this response.

retrievedAtdate-time

UTC timestamp when the query was executed.

queryLocationstringnullable

Description of the queried location (e.g., "KDFW", "32.8970,-97.0380 (25nm)", or "KDFW -> KAUS").

400If the airport identifier is missing or filter values are invalidApiErrorResponse

codestring

Machine-readable error code (e.g., "AIRCRAFT_NOT_FOUND").

messagestring

Human-readable error message suitable for display.

detailsstringnullable

Additional error details (only included in development environment).

servicestringnullable

Name of the external service that failed (only included for 503 errors).

validationErrorsRecord<string, string[]>nullable

Field-level validation errors (only for validation failures).

timestampstring

UTC timestamp when the error occurred.

traceIdstringnullable

Correlation ID for tracing the request.

pathstringnullable

Request path that generated the error.

503ApiErrorResponse