MSL Analysis Charts

The mean sea level (MSL) charts are drawn by forecasters 4 times a day. The analysis is the forecaster analysis of the current situation.

12.1 Latest Analysis for a Location

Request the latest analysis chart for the specified region. At this time the only region accepted is nz-au (New Zealand and Australia area).

12.1.1 API Call:

GET /aviation/chart/msl/analysis/{region}/latest

12.1.2 Path Parameter:

Path Parameter	Example	Description
region	nz-au	A supported region code. The region code must be lowercase. This parameter is Mandatory.

12.1.3 Example:

This example would return the latest MSL analysis chart for the NZ and Australia region.

GET /aviation/chart/msl/analysis/nz-au/latest

12.1.4 API Response:

{
    "version": "1.0",
    "issue-time": "2025-09-08T22:35:45Z",
    "path": "/aviation/api/aviation/chart/msl/analysis/nz-au/latest",
    "response": [
        {
            "met:locator": "`https://api.metservice.com/aviation/assets/chart/msl/nz-au/anal/2025/09/08/18/202509081800_202509081800_202509081950.gif",`
            "met:analysis-time": "2025-09-08T18:00:00Z",
            "met:product-name": "msl",
            "met:domain": "aviation",
            "met:issue-time": "2025-09-08T19:50:00Z",
            "av:chart-type": "msl",
            "met:prognosis-period": "000",
            "av:msl-region": "nz-au",
            "met:valid-at": "2025-09-08T18:00:00Z",
            "av:msl-type": "analysis",
            "met:validity": "18"
        }
    ]
}

12.2 Analysis for a Location at a specific validity

Request the latest analysis chart for the specified region and validity.

12.2.1 API Call:

GET /aviation/chart/msl/analysis/{region}/{validity}

12.2.2 Path Parameters:

Path Parameter	Example	Description
region	nz-au	A supported region code. The region code must be lowercase. This parameter is Mandatory.
validity	06	The validity of the chart. The validity is one of: 00, 06, 12, 18. This parameter is Mandatory.

12.2.3 Example:

This example would return the MSL analysis chart for the NZ and Australia region with a validity as specified in the API request.

GET /aviation/chart/msl/analysis/sw-pac/06

12.2.4 API Response:

{
    "version": "1.0",
    "issue-time": "2025-09-08T22:36:37Z",
    "path": "/aviation/api/aviation/chart/msl/analysis/sw-pac/06",
    "response": [
        {
            "met:locator": "`https://test-api.metservice.com/aviation/assets/chart/msl/sw-pac/anal/2025/09/08/06/202509080600_202509080600_202509080851.gif",`
            "met:analysis-time": "2025-09-08T06:00:00Z",
            "met:product-name": "msl",
            "met:domain": "aviation",
            "met:issue-time": "2025-09-08T08:51:00Z",
            "av:chart-type": "msl",
            "met:prognosis-period": "000",
            "av:msl-region": "sw-pac",
            "met:valid-at": "2025-09-08T06:00:00Z",
            "av:msl-type": "analysis",
            "met:validity": "06"
        }
    ]
}

12.3 Table of chart Region Codes

Region	Description
nz-au	New Zealand and Australia
sw-pac	South West Pacific
sth-ocean	Southern Ocean