NOTAM Data v2 (1.1.0)

Download OpenAPI specification:Download

Introduction

The NOTAM Data APIs, part of the Laminar Data Hub provides information on the current set of Notice to Airmen (NOTAM) alerts that have been issued.

There are many different types of NOTAMs in the aviation industry all of which are difficult to decipher. Some are mandatory or regulatory in nature, others advise pilots and other airspace operators, such as drone operators, of a closed airspace or runway, obstacles, or even alert airports and airlines about a nearby flock of birds.

The NOTAM APIs provide global coverage.

Please note that the NOTAM APIs cache responses for 60 seconds.

To request a compressed response from the NOTAM APIs, add the header Accept-Encoding: gzip to your request.

The service confirms that responses are compressed by including the response header Content-Encoding: gzip.

Licensing

The NOTAM Data APIs currently require a contract to use.

Schemas

Click the download button at the top of this document to download the OpenApi spec for this API.

Related articles

What is a NOTAM? - Explanation of NOTAMs

Displaying NOTAMs, restrictions and significant weather - Showcase article on how to display NOTAMs with restrictions and SIGMETs

Related products

Regulation - Current regulations that may impact flight operations

Weather - METAR, TAF and SIGMETS that may impact flight operations

NOTAMs by Flight Information Region

NOTAMs by flight information region

Retrieves a list of all NOTAMs for a given FIR in a GeoJSON response format.

For a list of possible ICAO prefixes and FIRs refer to the Reference Data APIs.

path Parameters
icao.prefix
required
string

First letter of the ICAO designator e.g. E (Case sensitive)

fir.icao
required
string

ICAO code of the FIR e.g. EGTT (Case sensitive)

query Parameters
qcode
string

The Q-Code or selection code such as QOBCE to obtain obstacle related NOTAMs.

Adding a Q-Code parameter will return only NOTAMS with the specified Q-Code.

Q-Code rules:

  • MUST start with a 'Q'
  • MUST be five characters
  • MUST be entered if 'TEXT_CONTAINS' is empty'
text_contains
string

Searches the 'text' field in the NOTAM response and returns only NOTAMs with text containing the specified values.

Multiple phrases can be searched for, by using a comma separated listed such as GPS,OBST. In this case, it returns only NOTAMs with text containing all the words.

Text Contains rules:

  • MUST have less than 21 characters
  • MUST only contain alphanumeric characters or commas
  • MUST be entered if 'Q-Code' is empty'
user_key
required
string

User Key Authentication Parameter

Responses

Response samples

Content type
application/json
{
  • "type": "FeatureCollection",
  • "features": [
    ],
  • "results": {
    }
}

NOTAMs by Aerodrome

NOTAMs by aerodrome

Retrieves a list of all NOTAMs for a given aerodrome in a GeoJSON response format.

path Parameters
aerodrome.icao
required
string

The ICAO code for an aerodrome e.g. EGLL

Aerodrome ICAO rules:

  • MUST be letters (case insensitive)
  • MUST be only four characters
query Parameters
qcode
string

The Q-Code or selection code such as QOBCE to obtain obstacle related NOTAMs.

Adding a Q-Code parameter will return only NOTAMS with the specified Q-Code.

Q-Code rules:

  • MUST start with a 'Q'
  • MUST be five characters
  • MUST be entered if 'TEXT_CONTAINS' is empty
text_contains
string

Searches the 'text' field in the NOTAM response and returns only NOTAMs with text containing the specified values.

Multiple phrases can be searched for, by using a comma separated listed such as GPS,OBST. In this case, it returns only NOTAMs with text containing all the words.

Text Contains rules:

  • MUST have less than 21 characters
  • MUST only contain alphanumeric characters or commas
  • MUST be entered if 'Q-Code' is empty'
user_key
required
string

User Key Authentication Parameter

Responses

Response samples

Content type
application/json
{
  • "type": "FeatureCollection",
  • "features": [
    ],
  • "results": {
    }
}

Temporary Flight Restrictions

Temporary flight restrictions

Retrieves a list of all active Temporary Flight Restrictions(TFRs) in a GeoJSON response format.

query Parameters
qcode
string

The Q-Code or selection code such as QOBCE to obtain obstacle related NOTAMs.

Adding a Q-Code parameter will return only NOTAMS with the specified Q-Code.

Q-Code rules:

  • MUST start with a 'Q'
  • MUST be five characters
text_contains
string

Searches the 'text' field in the NOTAM response and returns only NOTAMs with text containing the specified values.

Multiple phrases can be searched for, by using a comma separated listed such as GPS,OBST. In this case, it returns only NOTAMs with text containing all the words.

Text Contains rules:

  • MUST have less than 21 characters
  • MUST only contain alphanumeric characters or commas
user_key
required
string

User Key Authentication Parameter

Responses

Response samples

Content type
application/json
{
  • "type": "FeatureCollection",
  • "features": [
    ],
  • "results": {
    }
}

NOTAMs by Q-Code and Text

NOTAMs by Q-Code and text

Retrieves all the NOTAMs that matches the given type, Q-Code or text phrase or both in a GeoJSON response format.

At least one query parameter needs to be defined for the API to return a valid response

query Parameters
qcode
string

The Q-Code or selection code such as QOBCE to obtain obstacle related NOTAMs.

Adding a Q-Code parameter will return only NOTAMS with the specified Q-Code.

Q-Code rules:

  • MUST start with a 'Q'
  • MUST be five characters
text_contains
string

Searches the 'text' field in the NOTAM response and returns only NOTAMs with text containing the specified values.

Multiple phrases can be searched for, by using a comma separated listed such as GPS,OBST. In this case, it returns only NOTAMs with text containing all the words.

Text Contains rules:

  • MUST have less than 21 characters
  • MUST only contain alphanumeric characters or commas
user_key
required
string

User Key Authentication Parameter

Responses

Response samples

Content type
application/json
{
  • "type": "FeatureCollection",
  • "features": [
    ],
  • "results": {
    }
}

NOTAMs by User Defined Geometry

NOTAMs by user defined geometry

Returns all NOTAMs which have a geometry all or part of which falls (within 1 nautical mile) of the axis aligned bounding box of the GeoJson geometry

query Parameters
user_key
required
string

User Key Authentication Parameter

Request Body schema: application/geo+json

GeoJSON geometry marking area to show NOTAMs for

string

Responses

Request samples

Content type
application/geo+json
"string"

Response samples

Content type
application/json
{
  • "type": "FeatureCollection",
  • "features": [
    ],
  • "results": {
    }
}

NOTAMs by Country Code

NOTAMs by country code

Retrieves a list of all NOTAMs for a given ISO 3166 country code in a GeoJSON response format.

The NOTAM countryCode property is derived from the location property if it is a valid ICAO designator, not from the NOTAM text or geometry properties.

Here are some country code examples to use in therequest:

  • AUS
  • GBR
  • LUX

As mentioned in the response section, if your application does not have the agreed access to a particular country then you will recieve an unauthorized response when requesting NOTAM information for that country.

path Parameters
country.code.iso
required
string

The ISO 3166 code for a country code e.g. GBR.

Country Code ISO rules:

  • MUST be letters (case insensitive)
  • MUST be only three characters
query Parameters
user_key
required
string

User Key Authentication Parameter

Responses

Response samples

Content type
application/json
{
  • "type": "FeatureCollection",
  • "features": [
    ],
  • "results": {
    }
}
)