METAR API Documentation

This is the documentation to access the METAR API. Very simply, it returns the latest METAR report from a particular Airport.

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

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

Required URL Parameters

The following parameters are all required:

Optional URL Parameters

The following parameters are optional:

Output Values for JSON

The following output values are returned after successful query:

Error Codes for JSON

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

Sample Output

{
    "status": "success",
    "results": [
        {
            "metar": [
                {
                    "temperature": "4",
                    "dew_point": "-3",
                    "flight_rules": "VFR",
                    "wx_icon": "",
                    "weather": "",
                    "wind_direction": "140",
                    "wind_direction_label": "SE",
                    "wind_speed": "06",
                    "wind_gust_speed": "",
                    "clouds": [
                        " SCT at 13000 ft",
                        " BKN at 17000 ft",
                        " BKN at 25000 ft"
                    ],
                    "barometer": "30.24 inHg",
                    "visibility": "15 sm",
                    "date_time": "Feb 7 21:00 UTC",
                    "remarks": "AC3AC2CI1 SLP248",
                    "runway": [],
                    "windshear": [],
                    "trend_winds": [],
                    "trend_clouds": [],
                    "raw_metar": "CYYZ 072100Z 14006KT 15SM SCT130 BKN170 BKN250 04/M03 A3024 RMK AC3AC2CI1 SLP248"
                }
            ]
        }
    ]
}