This site uses cookies to personalise content, adverts, and to analyse traffic. I'm ok with that Learn More

Flight Ops Message API Documentation

This is the documentation to access the Flight Ops Message API. We have a group of volunteers who post special messages in relation to any of the Aircraft Manufacturers Test Flights. This could be flight schedules, weather, air traffic issues etc.

The API Platform is only available via a REST API, in which you have to let your application grab a URL with parameters and it returns all output in either JSON format. This makes it easy to grab the data using any Programming Language of your choice.

The root URL for the API is:

GET https://aviation.flights/api/flightops

Rate Limits

For the longest time it didn't need to be done but as of February 4, 2025 there is now a temporary rate limit of one request per 5 seconds.

Required Header Request

The following header is required on all requests:

x-api-key: The API key provided to you

Output Values for JSON

The following output values are returned after successful query:

Field
Description
flight_ops_message_id
The ID of the message
title
The title of the message
message
The body content of the message. Could contain HTML.
image
If available it will show a image URL that shows some visual context on the Flight Ops message.
airports
A list of ICAO airport codes involved in this message.
max_altitude
The maximum altitude this message is in effect for.
min_altitude
The minimum altitude this message is in effect for.
expiry_date
The Expiry date & time in UTC timezone.
coordinates
A array of coordinates, if this message applies to a geographic area.

Error Codes for JSON

The following are all error codes that can be returned with this function:

Error Message
Description
No API key provided!
No API key has been provided.
API key invalid!
The API key is invalid.

Sample Output

{
    "status": "success",
    "results": [{
        "flight_ops_message": [{
            "flight_ops_message_id": "12",
			"title": "Flight Ops Messgae Title",
			"message": "Flight Ops Messgae Body",
            "image": "",
			"airports": "CYYZ...CYUL...KDTW",
			"max_altitude": "34000",
			"min_altitude": "4000",
			"expiry_date": "Feb 9, 2023 23:35 UTC",
			"coordinates": [
				[48.55079626623113, -98.86472112237124],
				[46.39771492548868, -102.51218205987124],
				[44.84574326442325, -98.49118596612124],
				[46.533925177209085, -96.31589299737124],
				[48.55079626623113, -98.86472112237124]
			]
        }]
    }]
}
Chat