NOTAMs

Notices to Air Missions by airport, radius, or route with full detail and translations.

Endpoints

GET/api/v1/notams/{icaoCodeOrIdent}GET/api/v1/notams/radius POST/api/v1/notams/route

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

Get Notams For Airport

Parameters

Name	In	Type	Description
icaoCodeOrIdent*	path	string	ICAO code or FAA identifier (e.g., KDFW, DFW)

Responses

200Returns the NOTAMsNotamResponseDto

notamsNotamDto[]

typestring

idstringnullable

geometryNotamGeometryDtoGeoJSON geometry - can be Point, Polygon, or GeometryCollection

propertiesNotamPropertiesDto

totalCountinteger

retrievedAtdate-time

queryLocationstringnullable

400If the identifier is invalidApiErrorResponse

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

messagestringHuman-readable error message suitable for display.

detailsstringnullableAdditional error details (only included in development environment).

validationErrorsRecord<string, string[]>nullableField-level validation errors (only for validation failures).

timestampstringUTC timestamp when the error occurred.

traceIdstringnullableCorrelation ID for tracing the request.

pathstringnullableRequest path that generated the error.

503ApiErrorResponse

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

messagestringHuman-readable error message suitable for display.

detailsstringnullableAdditional error details (only included in development environment).

validationErrorsRecord<string, string[]>nullableField-level validation errors (only for validation failures).

timestampstringUTC timestamp when the error occurred.

traceIdstringnullableCorrelation ID for tracing the request.

pathstringnullableRequest path that generated the error.

Code Examples

curl \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://preflightapi-apim-service.azure-api.net/api/v1/notams/KJFK"

GET/api/v1/notams/radiusCommercial Pilot

Get Notams By Radius

Parameters

Name	In	Type	Description
latitude	query	number	Latitude in decimal degrees
longitude	query	number	Longitude in decimal degrees
radiusNm	query	number	Radius in nautical miles (max 100)

Responses

200Returns the NOTAMsNotamResponseDto

notamsNotamDto[]

typestring

idstringnullable

geometryNotamGeometryDtoGeoJSON geometry - can be Point, Polygon, or GeometryCollection

propertiesNotamPropertiesDto

totalCountinteger

retrievedAtdate-time

queryLocationstringnullable

400If parameters are invalidApiErrorResponse

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

messagestringHuman-readable error message suitable for display.

detailsstringnullableAdditional error details (only included in development environment).

validationErrorsRecord<string, string[]>nullableField-level validation errors (only for validation failures).

timestampstringUTC timestamp when the error occurred.

traceIdstringnullableCorrelation ID for tracing the request.

pathstringnullableRequest path that generated the error.

503ApiErrorResponse

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

messagestringHuman-readable error message suitable for display.

detailsstringnullableAdditional error details (only included in development environment).

validationErrorsRecord<string, string[]>nullableField-level validation errors (only for validation failures).

timestampstringUTC timestamp when the error occurred.

traceIdstringnullableCorrelation ID for tracing the request.

pathstringnullableRequest path that generated the error.

Code Examples

curl \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://preflightapi-apim-service.azure-api.net/api/v1/notams/radius?latitude=40.6413&longitude=-73.7781&radiusNm=10"

POST/api/v1/notams/routeCommercial Pilot

Get Notams For Route

The route can be specified using either: - AirportIdentifiers: Simple list of airport ICAO/FAA codes (e.g., ["KDFW", "KAUS"]) - RoutePoints: Ordered list of mixed airports and waypoints with coordinates If both are provided, RoutePoints takes precedence. Example RoutePoints request: ```json { "routePoints": [ { "airportIdentifier": "KDFW" }, { "name": "Lake Travis", "latitude": 30.4082, "longitude": -97.8538 }, { "latitude": 30.1, "longitude": -97.6, "radiusNm": 15 }, { "airportIdentifier": "KAUS" } ], "corridorRadiusNm": 25 } ```

Request BodyNotamQueryByRouteRequest

airportIdentifiersstring[]List of airport identifiers (ICAO codes or FAA identifiers) along the route. Use this for simple airport-only queries. For mixed airport/waypoint routes, use RoutePoints instead.

routePointsRoutePointDto[]Ordered list of route points (airports and/or waypoints) in flight sequence. Each point can be either an airport (by identifier) or a waypoint (by lat/lon). If both AirportIdentifiers and RoutePoints are provided, RoutePoints takes precedence.

airportIdentifierstringnullableAirport identifier (ICAO or FAA). If provided, this point is an airport.

namestringnullableOptional name for waypoints (used in route description)

latitudenumbernullableLatitude in decimal degrees. Required for waypoints (when AirportIdentifier is null).

longitudenumbernullableLongitude in decimal degrees. Required for waypoints (when AirportIdentifier is null).

radiusNmnumbernullableOptional radius in nautical miles for waypoints (max 100). Ignored for airports.

isAirportbooleanReturns true if this is an airport point, false if waypoint

corridorRadiusNmnumbernullableDefault radius in nautical miles for waypoints without a specific radius. If not specified, uses default from settings.

includeCorridorNotamsbooleanWhether to include NOTAMs from corridor sampling points between route points (future feature)

Responses

200Returns the NOTAMsNotamResponseDto

notamsNotamDto[]

typestring

idstringnullable

geometryNotamGeometryDtoGeoJSON geometry - can be Point, Polygon, or GeometryCollection

propertiesNotamPropertiesDto

totalCountinteger

retrievedAtdate-time

queryLocationstringnullable

400If the request is invalidApiErrorResponse

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

messagestringHuman-readable error message suitable for display.

detailsstringnullableAdditional error details (only included in development environment).

validationErrorsRecord<string, string[]>nullableField-level validation errors (only for validation failures).

timestampstringUTC timestamp when the error occurred.

traceIdstringnullableCorrelation ID for tracing the request.

pathstringnullableRequest path that generated the error.

503ApiErrorResponse

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

messagestringHuman-readable error message suitable for display.

detailsstringnullableAdditional error details (only included in development environment).

validationErrorsRecord<string, string[]>nullableField-level validation errors (only for validation failures).

timestampstringUTC timestamp when the error occurred.

traceIdstringnullableCorrelation ID for tracing the request.

pathstringnullableRequest path that generated the error.

Code Examples

curl \
  -X POST \
  -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "airportIdentifiers": [
    "KCLT",
    "KTYS",
    "KBNA"
  ],
  "corridorRadiusNm": 25
}' \
  "https://preflightapi-apim-service.azure-api.net/api/v1/notams/route"