GET/api/v1/notams/number/{notamNumber}Commercial Pilot

Get Notams By Number

Gets NOTAMs by NOTAM number in various formats.

Code Examples

curl \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://api.preflightapi.io/api/v1/notams/number/value"

curl \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://api.preflightapi.io/api/v1/notams/number/value"

Description

Searches the database for NOTAMs matching the given number. Unlike most NOTAM endpoints, this does *not* filter out cancelled or expired NOTAMs — so results may include recently expired or cancelled NOTAMs that have not yet been purged. This is *not* a historical archive; the database periodically purges stale NOTAMs.

Supported Input Formats

Bare number — 3997

Number/year — 3997/2025 or 3997/25

Month-prefix — 03/420

Domestic — BNA 420, BNA 03/420, !BNA 03/420

FDC — FDC 4/3997, !FDC 4/3997

ICAO — A1234/25

Disambiguation

Bare numbers (e.g., 3997) may match multiple NOTAMs across different accounts or years. Include the year, account ID, or full domestic format to narrow results.

Examples

GET /api/v1/notams/number/3997 — bare number (may return multiple matches)
GET /api/v1/notams/number/3997%2F2025 — number with year (%2F = /)
GET /api/v1/notams/number/BNA%20420 — domestic format (%20 = space)
GET /api/v1/notams/number/A1234%2F25 — ICAO format

Parameters

Name	In	Type	Description
notamNumber*	path	string	NOTAM number in any supported format (URL-encoded)

Response Schema

200Returns the matching NOTAMs

typestring

GeoJSON type, always "Feature".

idstringnullable

Unique NOTAM feature identifier.

400If the input cannot be parsed or is 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.

404If no NOTAMs match the given numberApiErrorResponse