NOTAMs

A NOTAM or NOtice To AirMen is a short message with information pertaining to a specific airport, region of flight control area such as an ATC or FIR zone.

Entry point
https://www.avdelphi.com/api/1.0/notam.svc
Parameter Type Values
api_key
mandatory Your API Key
api_password
mandatory Your API Password. Send this OR an access_token
api_access_token
mandatory Your API access token which can be used instead of sending your password.
cmd
mandatory API Command
itemlist
optional List of fields to return. Each command has a specific list of items that can be returned.
format
optional Data return type XML,JSON,CSV or CSV-
  • JSON is the default when no format parameter is specified
  • CSV output starts with a series of comment lines - starting with the # character. You may need to remove these before importing the CSV data.
  • CSV- output omits the comment lines - including any error messages.
search parameter
see note below Each command has a set of parameters that can be specified to identify the target data, such as registration, serial number etc.

Examples

Note When using the TEST credentials (TESTAPIKEY & TESTAPIKEYPASSWORD) the text search result will always be for the text 'SNOWTAM' and the 'code_icao' will always use LSZH (Zurich).

Get the latest NOTAMS for a specific airport ot ATC/FIR ICAO code
https://www.avdelphi.com/api/1.0/notam.svc?api_key=TESTAPIKEY&api_password=TESTAPIKEYPASSWORD&cmd=latest&code_icao=lszh


Result (JSON)
{
	"api":"notam",
	"version":1,
	"command":"latest",
	"num_results":2,
	"result_type":"valid",
	"results_limit":2,
	"rate_limit":
	{
		"notam":
		{
			"current":1,
			"maximum":5
		}
	},
	"result":
	[
		{
			"icao":"lszh",
			"notam_id":"A0256\/18 NOTAMN",
			"text":"Q) LSAS\/QMRLC\/IV\/NBO\/A\/000\/999\/4727N00833E005\nA) LSZH B) 1806082100 C) 1806090400\n
			E) RWY 16\/34 CLSD DUE TO WIP. ACTUAL CLOSURE BCST ON ATIS.\n"
		},
		{
			"icao":"lszh",
			"notam_id":"A0254\/18 NOTAMN",
			"text":"Q) LSAS\/QMRLC\/IV\/NBO\/A\/000\/999\/4727N00833E005\nA) LSZH B) 1805292100 C) 1805310400\n
			D) TUE-WED 2100-2359 WED-THU 0000-0400\nE) RWY 10\/28 CLSD DUE TO WIP. ACTUAL CLOSURE BCST ON ATIS.\n"
		}
	]
}


https://www.avdelphi.com/api/1.0/notam.svc?api_key=TESTAPIKEY&api_password=TESTAPIKEYPASSWORD&cmd=latest&code_icao=lszh&format=csv


Result (CSV)
#api=notam
#version=1
#command=latest
#result_type=valid
#icao,notam_id,text
lszh,"A0256/18 NOTAMN","Q) LSAS/QMRLC/IV/NBO/A/000/999/4727N00833E005 A) LSZH B) 1806082100 C) 1806090400 E) RWY 16/34 CLSD DUE TO WIP. ACTUAL CLOSURE BCST ON ATIS. "
lszh,"A0254/18 NOTAMN","Q) LSAS/QMRLC/IV/NBO/A/000/999/4727N00833E005 A) LSZH B) 1805292100 C) 1805310400 D) TUE-WED 2100-2359 WED-THU 0000-0400 E) RWY 10/28 CLSD DUE TO WIP. ACTUAL CLOSURE BCST ON ATIS. "



https://www.avdelphi.com/api/1.0/notam.svc?api_key=TESTAPIKEY&api_password=TESTAPIKEYPASSWORD&cmd=latest&code_icao=lszh&format=xml


Result (XML)
<?xml version="1.0"?>
	<data>
		<api>notam</api>
		<version>1</version>
		<command>latest</command>
		<num_results>2</num_results>
		<result_type>valid</result_type>
		<results_limit>2</results_limit>
		<rate_limit>
			<notam>
				<current>4</current>
				<maximum>5</maximum>
			</notam>
		</rate_limit>
		<result>
			<item0>
				<icao>lszh</icao>
				<notam_id>A0256/18 NOTAMN</notam_id>
				<text>Q) LSAS/QMRLC/IV/NBO/A/000/999/4727N00833E005
						A) LSZH B) 1806082100 C) 1806090400
						E) RWY 16/34 CLSD DUE TO WIP. ACTUAL CLOSURE BCST ON ATIS.
				</text>
			</item0>
			<item1>
				<icao>lszh</icao>
				<notam_id>A0254/18 NOTAMN</notam_id>
				<text>Q) LSAS/QMRLC/IV/NBO/A/000/999/4727N00833E005
					A) LSZH B) 1805292100 C) 1805310400
					D) TUE-WED 2100-2359 WED-THU 0000-0400
					E) RWY 10/28 CLSD DUE TO WIP. ACTUAL CLOSURE BCST ON ATIS.
				</text>
			</item1>
		</result>
	</data>

Pricing

Access to this API is based on a per ICAO/FIR per month pricing plan. Volume discounts apply. Contact your API team using the contact form below to create or edit your plan.

Mandatory Parameters

api_key

TypeMandatory
ContentHexadecimal value of your API key.
Get your API key here if you don't have one.
Case sensitiveYES
Example
api_key=NTlhZGUl7kZW

Back to top 

api_password

TypeMandatory (You must send either password or access token with each request)
ContentHexadecimal value of your API password.
Get your API key here if you don't have one.
Case sensitiveYES
Example
api_password=ciUyQmdPWTJaTGNQc2pkU05tRlVNaWZZ11NpdCUyRmVpVEF6THBm7SUzRA

Back to top 

api_access_token

TypeMandatory (You must send either password or access token with each request)
ContentHexadecimal value of your API access token.
Click on any API Key here to manage access tokens.
Case sensitiveYES
Example
api_access_token=2d1a099fd880c0fcfd6fd5e63a769e11b2c2db92

Back to top 

Commands

cmd

TypeMandatory
ContentAPI command to execute
Case sensitiveNo
Command Purpose
latest Get the latest NOTAMs for the specified airport or ATC FIR Zone.
search Search all notams for some specific text.
Example
cmd=latest
cmd=search

Back to top 

latest

FunctionGet the latest NOTAMs for the specified airport or ATC FIR Zone.
Search ParameterUse any ONE of the following parameters to specify which airport to return data for.

ParameterDescription
Back to commands 

search

FunctionSearch all notams for some specific text.
Search ParameterUse any ONE of the following parameters to specify which airport to return data for.

ParameterDescription
textContents of the NOTAM message
notam_idNOTAM ID such as A0013/16
notam_classType of NOTAM i.e. SNOWTAM, ASHTAM
Back to commands 

watchlist

FunctionGets NOTAMS for a specific watch list. Watch lists are automatically generated for certain events.
Search ParameterUse any ONE of the following parameters to specify which airport to return data for.

ParameterDescription
textContents of the NOTAM message
notam_idNOTAM ID such as A0013/16
Back to commands 

Optional Parameters

format

TypeOptional
ContentSpecifies the data return format JSON,XML or CSV(-). By default, data is returned as JSON.
Case sensitiveNo
Example
format=xml
format=csv
format=csv-
format=json

Back to top 

itemlist

TypeOptional depending on command used. Some commands return default data, others allow you to specify which fields to return.
ContentList of fields to retrieve separated with semi-colons.
Case sensitiveNo
Fieldname Description
icao Airport ICAO code or ATC/FIR Zone code
notam_id NOTAM ID such as A0013/16
text Contents of the NOTAM message
effective_date Date at which the NOTAM becomes effective yyyy-mm-dd hh:mm:ss
notam_class Type of NOTAM i.e. SNOWTAM, ASHTAM
valid_from_date Date at which the NOTAM is valid from yyyy-mm-dd
valid_to_date Date at which the NOTAM validity ends yyyy-mm-dd
Example
itemlist=icao;notam_id;text

Back to top