Aviation API CLASSIC
The Aviation API provides high-resolution meteorological feeds designed for aviation customers. These feeds support flight planning, take-off and landing operations, and real-time cockpit decisions.
| Auth Type | Header Name | Base URL | Protocol |
|---|---|---|---|
| API Key | apikey | https://api.metservice.com | REST |
Key Features
- Comprehensive Forecasts: Includes TAF (Terminal Aerodrome Forecasts) and METARs (Aerodrome Reports).
- Graphical Charts: High-quality Significant Weather (SigWx), MSL Analysis, and GRAFOR charts.
- GeoJSON Support: Modern spatial data formats for integration into Electronic Flight Bags (EFB) and charting software.
- Global & Local Scope: Covers New Zealand domestic regions and World Area Forecast System (WAFS) products.
Getting Started
To use the Aviation API, you must have a valid API Key.
Requesting Access
Access is currently granted via manual onboarding. Please email api.queries@metservice.com with the following details:
- Contact Name & Email
- Company Name
- Intended Use Case
- Specific API products requested (e.g., TAF, METAR, SigWx Charts)
Authentication
Once granted access, include your API Key in the header of every request:
apikey: YOUR_API_KEY
Rate Limiting & Error Handling
While specific throughput limits (e.g., calls per minute) are defined in your individual API Access Agreement, usage must always be "fair, reasonable, and not excessive" as per the Terms and Conditions.
Common Status Codes
| Code | Description |
|---|---|
| 200 | OK - Request successful. |
| 400 | Bad Request - Check syntax or parameters. |
| 401 | Unauthorized - check your apikey header. |
| 404 | Not Found - Resource or location does not exist. |
| 500 | Internal Server Error - Please contact support if this persists. |
Legal & Compliance
Usage of the Aviation API is subject to specific terms:
- Disclaimer: Data is provided "as is" and use is at your own risk. MetService gives no warranties regarding availability or suitability for a particular purpose.
- Attribution: You must display: "This data was provided by MetService Limited" in your application.
- Liability: MetService's liability is strictly limited as per Clause 7 of the Terms and Conditions.
Available Products
The API is organized into several key meteorological products:
- Terminal Forecasts: TAF, METAR, SIGMET, and Take Off Data (TOD).
- Advisory Services: Volcanic Ash Advisories (VAA) and Volcanic Ash Graphics (VAG).
- Aviation Charts: Significant Weather (SigWx), GRAFOR, and MSL Prognosis/Analysis charts.
- Flight Level Data: GNZSIGWX flight level charts and GeoJSON feeds.
- Asset: GNZSIGWX GeoJSON Style Schema for rendering overlays.
For complete details on parameters and response schemas, refer to the Technical Reference.
Support
Support is provided at MetService's sole discretion. For access requests or critical operational issues, email api.queries@metservice.com.