Aviation API
11 Graphical Aviation Forecast (GRAFOR) Charts
The Graphical Aviation Forecast Chart (GRAFOR) is a forecast issued for the NZZC FIR. The chart issued provides a forecast for various flight conditions from SFC to FL100 and grouped by regions affected. They are issued 2 times a day, valid at 00, 06, 12, and 18 (UTC).
11.1 Latest GRAFOR Set
Request the latest GRAFOR chart set.
11.1.1 API Call:
GET /aviation/chart/grafor/latest
11.1.2 Example:
This example will return links to the latest set of charts.
GET /aviation/chart/grafor/latest
11.1.3 API Response:
{
"version": "1.0",
"issue-time": "2025-09-08T21:50:03Z",
"path": "/aviation/api/aviation/chart/grafor/latest",
"response": [
{
"met:locator": "https://api.metservice.com/aviation/assets/grafor/20250908/090000_082057.png",
"met:product-name": "grafor",
"met:domain": "aviation",
"met:issue-time": "2025-09-08T20:57:00Z",
"met:valid-at": "2025-09-09T00:00:00Z",
"met:validity": "00"
},
{
"met:locator": "https://api.metservice.com/aviation/assets/grafor/20250908/090600_082100.png",
"met:product-name": "grafor",
"met:domain": "aviation",
"met:issue-time": "2025-09-08T21:00:00Z",
"met:valid-at": "2025-09-09T06:00:00Z",
"met:validity": "06"
},
{
"met:locator": "https://api.metservice.com/aviation/assets/grafor/20250908/091200_082104.png",
"met:product-name": "grafor",
"met:domain": "aviation",
"met:issue-time": "2025-09-08T21:04:00Z",
"met:valid-at": "2025-09-09T12:00:00Z",
"met:validity": "12"
}
]
}
11.2 Latest for a Validity
Request the latest GRAFOR chart for a specific validity.
11.2.1 API Call:
GET /aviation/chart/grafor/{validity}
11.2.2 Path Parameter:
Path Parameter | Example | Description |
---|---|---|
validity | 06 | A supported valid at time: 00, 06, 12, 18. This path parameter is Mandatory. |
11.2.3 Example:
This example will return a link to the latest grafor chart for validity 06Z.
GET /aviation/chart/grafor/06
11.2.4 API Response:
{
"version": "1.0",
"issue-time": "2025-09-08T21:50:49Z",
"path": "/aviation/api/aviation/chart/grafor/06",
"response": [
{
"met:locator": "https://api.metservice.com/aviation/assets/grafor/20250908/090600_082100.png",
"met:product-name": "grafor",
"met:domain": "aviation",
"met:issue-time": "2025-09-08T21:00:00Z",
"met:valid-at": "2025-09-09T06:00:00Z",
"met:validity": "06"
}
]
}
11.3 Valid GRAFOR charts for the next n hours
Request the GRAFOR charts that will be valid in the next n hours.
11.3.1 API Call:
GET /aviation/chart/grafor/next/{n}/hours
11.3.2 Path Parameter:
Path Parameter | Example | Description |
---|---|---|
n | 06 | The number of hours into the future that the valid at time of the chart should fall within. This can be up to 24 hours. This path parameter is Mandatory. |
11.3.3 Example:
This example will return links to the charts that are valid in the next 12 hours.
GET /aviation/chart/grafor/next/12/hours
11.3.4 API Response:
{
"version": "1.0",
"issue-time": "2025-09-08T21:52:04Z",
"path": "/aviation/api/aviation/chart/grafor/next/12/hours",
"response": [
{
"met:locator": "https://api.metservice.com/aviation/assets/grafor/20250908/090000_081105.png",
"met:product-name": "grafor",
"met:domain": "aviation",
"met:issue-time": "2025-09-08T11:05:00Z",
"met:valid-at": "2025-09-09T00:00:00Z",
"met:validity": "00"
},
{
"met:locator": "https://api.metservice.com/aviation/assets/grafor/20250908/090000_081242.png",
"met:product-name": "grafor",
"met:domain": "aviation",
"met:issue-time": "2025-09-08T12:42:00Z",
"met:valid-at": "2025-09-09T00:00:00Z",
"met:validity": "00"
},
{
"met:locator": "https://api.metservice.com/aviation/assets/grafor/20250908/090000_082057.png",
"met:product-name": "grafor",
"met:domain": "aviation",
"met:issue-time": "2025-09-08T20:57:00Z",
"met:valid-at": "2025-09-09T00:00:00Z",
"met:validity": "00"
},
{
"met:locator": "https://api.metservice.com/aviation/assets/grafor/20250908/090600_081107.png",
"met:product-name": "grafor",
"met:domain": "aviation",
"met:issue-time": "2025-09-08T11:07:00Z",
"met:valid-at": "2025-09-09T06:00:00Z",
"met:validity": "06"
},
{
"met:locator": "https://api.metservice.com/aviation/assets/grafor/20250908/090600_082100.png",
"met:product-name": "grafor",
"met:domain": "aviation",
"met:issue-time": "2025-09-08T21:00:00Z",
"met:valid-at": "2025-09-09T06:00:00Z",
"met:validity": "06"
}
]
}