Data API

OpenAPI

Full API specification documentation is provided in OpenAPI YAML and the following interactive interface.

Cache

Access to current observations and forecasts in one file. Use of these files is recommended instead of making excessively large or frequent custom queries. METARs, AIRMETs/SIGMETs, and PIREPS update once a minute, TAFs update every ten minutes, and stations update once per day.

Using the API

REST API endpoint are accessable at /api/data as outlined in the schema information. For example METARs are found at https://aviationweather.gov/api/data. Most requests require query parameters in order to specify constaints of the data being requested. For example the latest METAR from Kansas City International in JSON format can be requested by specifying the four letter ICAO identifer with https://aviationweather.gov/api/data/metar?ids=KMCI&format=json.

Requests may be made using more web browsers, command line utilities, and programming language libraries using modern HTTPS connections.

Guidelines

• Please carefully consider requests to limit load on the system.
• Set a custom user agent to prevent automated filtering inadvertantly blocking valid traffic.
• Wait between consecutive requests — maximum 100 requests per minute.
• Exceeding request limits will result in access being temporarily blockeds.

Restrictions

• All requests are rate limited to 100 requests per minute and all API endpoints should not be consumed more frequently than 1 request/min per thread.
• Most endpoints return a maximum of 1,000 entries.
• Cross-origin resource sharing is not permitted at this time.

Troubleshooting

• Ensure your network connection is stable.
• Verify that firewalls or proxies are not blocking your requests.
• Ensure you are connecting via HTTPS.