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

Flight Information Region (FIR) API Documentation

This is the documentation to access the Flight Information Region (FIR) API. It returns information about Flight Information Regions.

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/fir

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

Optional URL Parameters

The following parameters are all optional:

Parameter
Description
icao
The specific FIR ICAO code (i.e. CZWG)
q
Use it to search for a specific FIR based on its ICAO or name (i.e. CZWG or Toronto)

Output Values for JSON

The following output values are returned after successful query:

Field
Description
fir_id
The ID of the FIR
icao
The ICAO code of the FIR
prefix
The prefix of the FIR
name
The name of the FIR
coordinates
A array of coordinates of the geographic area the FIR covers

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": [
        {
            "fir": [
                {
                    "fir_id": "17",
                    "icao": "CZYZ",
                    "prefix": "TOR",
                    "name": "Toronto ACC",
                    "coordinates": [
                        [
                            -76.183333,
                            44.233333
                        ],
                        [
                            -76.233333,
                            44.204167
                        ],
                        [
                            -76.283333,
                            44.204167
                        ],
                        [
                            -76.333333,
                            44.166667
                        ],
                        [
                            -76.416667,
                            44.104167
                        ],
                        [
                            -76.791667,
                            43.633333
                        ],
                        [
                            -78.677778,
                            43.633333
                        ],
                        [
                            -78.75,
                            43.6
                        ],
                        [
                            -78.75,
                            43.433333
                        ],
                        [
                            -79.024444,
                            43.197778
                        ],
                        [
                            -79.058333,
                            42.95
                        ],
                        [
                            -79.844444,
                            42.836111
                        ],
                        [
                            -80.895833,
                            42.779167
                        ],
                        [
                            -81.220833,
                            42.741667
                        ],
                        [
                            -81.970833,
                            42.829167
                        ],
                        [
                            -82.466667,
                            42.870833
                        ],
                        [
                            -82.416667,
                            43
                        ],
                        [
                            -82.125,
                            43.616667
                        ],
                        [
                            -82.185556,
                            43.916667
                        ],
                        [
                            -82.5,
                            45.333333
                        ],
                        [
                            -83.583333,
                            45.816667
                        ],
                        [
                            -84.358333,
                            46.25
                        ],
                        [
                            -84.533333,
                            46.383333
                        ],
                        [
                            -85.633333,
                            46.75
                        ],
                        [
                            -87,
                            47.083333
                        ],
                        [
                            -87,
                            49.533333
                        ],
                        [
                            -86.266667,
                            50
                        ],
                        [
                            -83.141667,
                            52
                        ],
                        [
                            -80,
                            53.466667
                        ],
                        [
                            -79,
                            49
                        ],
                        [
                            -79,
                            48.587222
                        ],
                        [
                            -79.050166,
                            48.575833
                        ],
                        [
                            -79.143167,
                            48.558
                        ],
                        [
                            -79.225167,
                            48.536667
                        ],
                        [
                            -79.273333,
                            48.519
                        ],
                        [
                            -79.350833,
                            48.476333
                        ],
                        [
                            -79.403333,
                            48.441167
                        ],
                        [
                            -79.467833,
                            48.388167
                        ],
                        [
                            -79.501333,
                            48.342667
                        ],
                        [
                            -79.5255,
                            48.300167
                        ],
                        [
                            -79.556167,
                            48.191
                        ],
                        [
                            -79.555333,
                            48.134
                        ],
                        [
                            -79.5425,
                            48.087833
                        ],
                        [
                            -79.521333,
                            48.025
                        ],
                        [
                            -79.473333,
                            47.9585
                        ],
                        [
                            -79.4175,
                            47.904167
                        ],
                        [
                            -79.3405,
                            47.854667
                        ],
                        [
                            -79.2685,
                            47.818667
                        ],
                        [
                            -79.156167,
                            47.783667
                        ],
                        [
                            -79.023167,
                            47.755833
                        ],
                        [
                            -78.9045,
                            47.753667
                        ],
                        [
                            -78.801,
                            47.758167
                        ],
                        [
                            -78.705667,
                            47.784
                        ],
                        [
                            -78.6355,
                            47.804
                        ],
                        [
                            -78.565278,
                            47.84
                        ],
                        [
                            -77.533333,
                            47.1
                        ],
                        [
                            -77.25,
                            46.947222
                        ],
                        [
                            -77.25,
                            46.133333
                        ],
                        [
                            -76.927778,
                            45.961111
                        ],
                        [
                            -76.266667,
                            45.8375
                        ],
                        [
                            -76.183333,
                            44.233333
                        ]
                    ]
                }
            ]
        }
    ]
}
Chat