GET/api/v1/notams/searchCommercial Pilot

Search Notams

Searches NOTAMs across all locations using filter criteria.

Code Examples

curl \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://api.preflightapi.io/api/v1/notams/search?classification=value&feature=value&freeText=value&effectiveStartDate=value&effectiveEndDate=value&accountability=value&location=value&notamNumber=value&latitude=40.6413&longitude=-73.7781&radius=10&lastUpdatedDate=value&limit=25"

curl \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://api.preflightapi.io/api/v1/notams/search?classification=value&feature=value&freeText=value&effectiveStartDate=value&effectiveEndDate=value&accountability=value&location=value&notamNumber=value&latitude=40.6413&longitude=-73.7781&radius=10&lastUpdatedDate=value&limit=25"

Description

Searches the entire active NOTAM database without requiring a specific airport or location. At least one filter parameter is required to prevent unbounded queries. Mirrors the FAA NMS API query parameters for flexible NOTAM filtering.

Pagination

Results are returned with cursor-based pagination. Pass the pagination.nextCursor value from a previous response as the cursor query parameter to retrieve the next page. The limit parameter controls page size (1–500, default 100).

Parameter Pairing Rules

notamNumber must be paired with location or accountability

latitude, longitude, and radius must all be provided together

effectiveStartDate and effectiveEndDate must both be provided or both omitted

lastUpdatedDate: when provided, returns both active and inactive NOTAMs modified since that time

Examples

GET /api/v1/notams/search?classification=FDC — all active FDC NOTAMs
GET /api/v1/notams/search?freeText=CLOSED&limit=50 — text search, 50 per page
GET /api/v1/notams/search?feature=RWY&classification=DOMESTIC — combined filters
GET /api/v1/notams/search?accountability=BNA — NOTAMs by issuing office
GET /api/v1/notams/search?location=DFW — NOTAMs for a location
GET /api/v1/notams/search?notamNumber=420&location=DFW — NOTAM by number + location
GET /api/v1/notams/search?latitude=32.8998&longitude=-97.0403&radius=25 — spatial search
GET /api/v1/notams/search?lastUpdatedDate=2025-03-01T00:00:00Z — recently modified (active + inactive)
GET /api/v1/notams/search?classification=FDC&cursor=ABC123&limit=100 — next page

Returns paginated results of NotamDto

Parameters

Name	In	Type	Description
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.
accountability	query	string?	Optional accountability code (issuing office) filter, e.g., "BNA", "FDC". Alphanumeric, max 10 characters.
location	query	string?	Optional location identifier filter (FAA domestic or ICAO code), e.g., "DFW" or "KDFW". Alphanumeric, max 10 characters.
notamNumber	query	string?	Optional NOTAM number filter. Must be paired with location or accountability.
latitude	query	number?	Optional latitude in decimal degrees (-90 to 90). Must be paired with longitude and radius.
longitude	query	number?	Optional longitude in decimal degrees (-180 to 180). Must be paired with latitude and radius.
radius	query	number?	Optional search radius in nautical miles (0 to 100). Must be paired with latitude and longitude.
lastUpdatedDate	query	string?	Optional ISO 8601 timestamp. Returns NOTAMs modified since this time, including inactive NOTAMs.
cursor	query	string?	Opaque cursor value from a previous response's pagination.nextCursor field. Omit or leave null to start from the first page.
limit	query	integer	Maximum number of items to return per page. Minimum 1, maximum 500, default 100.

Response Schema

200Returns the paginated matching NOTAMsPaginatedResponseOfNotamDto

400If no filters are provided, or if 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