Introduction
This is version 3 of the MET Weather API. For additional information, please read our Getting Started tutorial, Usage guide, Terms of Service and F.A.Q.
Available products:
| Product | Version | Also | Description | Available | Schema | Swagger | Healthz |
|---|---|---|---|---|---|---|---|
| Airqualityforecast | 0.1 | Forecast of air-quality for locations in Norway ⚠ | ✓ | ||||
| Aviationforecast | 1.6 | Textual aviation weather forecasts ✈ | ✓ | ✓ | |||
| Forestfireindex | 1.1 | Reporting danger level of forest fires. ⚠ | ✓ | ✓ | |||
| Frost | 1.0 | REST API for meteorogical observation data ⛅🌡☇ | ✓ | ||||
| Geosatellite | 1.4 | Images from geostationary satellites 🛰 | ✓ | ✓ | |||
| Gribfiles | 1.1 | Serve grib files on the coast from Oslo and Western Norway ⚓ | ✓ | ✓ | |||
| Icemap | 1.0 | Maps as images showing current ice conditions in the arctic regions. ⚓ | ✓ | ✓ | |||
| Locationforecast | 2.0 | Weather forecast for a specified place ⛅ | ✓ | ✓ | |||
| MetAlerts | 1.1 | Weather alerts from the Norwegian Meteorological Institute ⚠ | ✓ | ✓ | |||
| Metgc | 1.0 | Deliver meteorological forecast data in METGM/C format for defined areas ⚔ | ✓ | ✓ | |||
| Metgm | 1.0 | Deliver meteorological forecast data in METGM/C format for defined areas ⚔ | ✓ | ✓ | |||
| NLAroutes | 1.0 | Vertical cross sections for air ambulance flight routes ✈ | ✓ | ✓ | |||
| Nowcast | 2.0 | Immediate weather forecast for specified locations in the Nordic area ⛅ | ✓ | ✓ | |||
| Oceanforecast | 0.9 | Ocean forecast for a specified place ⚓ | ✓ | ||||
| Oslofjord | 0.1 | Current maps for Oslofjorden and Drammensfjorden ⚓ | ✓ | ✓ | |||
| Polarsatellite | 1.1 | Images from satellites in polar orbit 🛰 | ✓ | ✓ | |||
| Probabilityforecast | 1.1 | Probability forecast for a specified place ⛅ | ✓ | ✓ | |||
| Radar | 2.0 | Radar images from various locations ⛅☇ | ✓ | ✓ | |||
| Routeforecast | 1.0 | Maps and vertical cross sections for offshore flight routes ✈ | ✓ | ✓ | |||
| Sigcharts | 1.0 | Significant Weather Charts for aviation ✈ | ✓ | ✓ | |||
| Sigmets | 2.0 | Get sigmets and airmets for Norway ✈ | ✓ | ||||
| Soundprofile | 1.0 | Vertical profiles in the ocean off the Norwegian coast ⚓ | ✓ | ✓ | |||
| Spotwind | 1.1 | Spotwind forecasts for airport landing systems ✈ | ✓ | ✓ | |||
| Subjectiveforecast | 1.0 | Forecasts and analyses charts from the meteorologist ⛅ | ✓ | ✓ | |||
| Sunrise | 2.0 | Calculate sun/moon rise/set for a given place 🌣 | ✓ | ✓ | |||
| Tafmetar | 1.0 | Receive Taf/Metar from airports ✈ | ✓ | ✓ | |||
| Textforecast | 2.0 | Textual weather forecast for Norwegian land and sea areas ⛅⚓ | ✓ | ✓ | ✓ | ||
| Tidalwater | 1.1 | Tidal water information ⚓ | ✓ | ✓ | |||
| Turbulence | 1.1 | Turbulence prognosis ✈ | ✓ | ✓ | |||
| VerticalProfile | 1.1 | Vertical weather profiles for aviation ✈ | ✓ | ✓ | |||
| Volcanicashforecast | 0.1 | Norwegian national volcanic ash products including forecast ✈ | ✓ | ||||
| Weathericon | 2.0 | collection of weather icons. ⚙ | ✓ |
| Legend | Meaning |
|---|---|
| Normal | This product is in regular production. Changes will be announced in the mailing list. |
| Beta | This product may change without further notice, and/or service may be interrupted. Production use is not recommended without further agreement. |
| Deprecated | This product will be discontined soon. Please check documentation and update your systems. |
| External | Separate service outside WeatherAPI. May have different TOS and license. |
This list is also available in APIs.json, JSON and XML formats.
Data restrictions
We have a few cases with data that are not freely available. This is marked in the documentation for each product, under the heading Restrictions. For more information, see License and Data Use.
Versions
See the documentation for product versioning. We also recommend reading the section about error handling.
Errors and return values
Sometimes things don't go as planned. The API will return a (hopefully)
explanatory message, formatted as HTML (if using a browser or sending an
Accept: text/html request header), otherwise as plain text.
For more information, see the HTTP status codes documentation. In addition you can also check the HTTP status code and the X-ErrorClass response header when using an automated client.
ErrorClass header
In addition to the HTTP Status Code the API also returns an X-ErrorClass response header which might explain further the cause of the error. The following codes are currently used:
| ErrorClass | Status Code | Description |
|---|---|---|
| ServiceUnavailable | 503 Service Unavailable | Server error |
| Outsidegeographicarea | 422 Unprocessable Entity | The location is outside the geographic area supported by the product. |
| Unexpectedmissingdata | 502 Bad Gateway | I cannot find my data |
| Nodata | 404 Not Found | We have no data for this request |
| Encoding | 400 Bad Request | Character set encoding error |
| IllegalUserAgent | 403 Forbidden | Please use a unique, identifying User-Agent header |
| Accesscontrol | 401 Unauthorized | Access control error |
| Permissiondenied | 401 Unauthorized | Permission denied |
| ErrorFromBackend | 502 Bad Gateway | Backend error |
| Ratelimitation | 429 Too Many Requests | Traffic rate limitation |
| Parameter | 400 Bad Request | Invalid parameter |
| Doesnotapply | 400 Bad Request | Requested operation does not apply |
| Internal | 500 Internal Server Error | Something inside me broke |
| Outsidetimerange | 404 Not Found | I have no data for the requested date/time |
| Validation | 404 Not Found | Validation error |
| Format | 400 Bad Request | Invalid formatting |
This list is non-exhaustive, additional codes can be added over time (normally implemented in future versions).
Note that Unexpectedmissingdata returned a 404 in the old (version 2) API. This was changed as it really is not a Client Error but an error in the backend, but that was impossible for the user to discern.