v3.1

Versioning introduced. From Version 3.1 onwards, all endpoints will begin with a version number (v3_1) to ensure better maintainability of the API. example: forecast/latitude/longitude -> /v3_1/forecast/latitude/longitude. Please note that endpoints without a version number will be forwarded to the latest endpoint version after July 31, 2023. Please see our documentation on versioning of our API.

warnings:

We added new endpoints within the new API version. Some of the old endpoints won't be included and are deprecated under the old API version. Deprecated endpoints will have the same output as before but will be terminated by July 31, 2023

changes for the new endpoints:

• nearestWarnings, nearestSevereWarnings, latestwarnings, latestSevereWarnings: no longer available
• activeWarnings/certainty: no longer available
• activeWarnings/ii: no longer available
• activeWarnings/responseType: no longer available
• activeWarnings/sent: fixed datetime to reflect correct timezone
• activeWarnings/severity: corrected output to german (was english)
• activeWarnings/status: corrected output to german (was english)
• activeWarnings/urgency: no longer available

v3.0

We are switching to a different backend. Some values are changed/removed

forecast:

• hourly/wind/gusts/text: no longer available (null value returned)
• hourly/activeWarnings: corrected data
• spaces/activeWarnings: corrected data
• summary/activeWarnings: corrected data
• summary/weatherNg/state: correct number displayed

Hood/weather:

• items/radar/amount/unit: unit always has string value
• items/radar/amount/value: value always has int or float value
• items/radar/prectype: no longer available (null value returned)
• items/shortText/time: no longer available (null value returned)
• station: will always return a dictionary, no longer sometimes null

Locations:

• items returns 10 items standard
• items/nameTranslations: no longer available (empty list returned)
• items/relevance: no longer available (null value returned)
• items/searchContext/distance: no longer available (null value returned)
• pagination: no longer available (null value returned)

Overview

To ensure better maintainability and backward compatibility of our API, we have introduced versioning starting from version 3.1. All endpoints will now begin with a version number (e.g., v3_1) to indicate the API version being used.

Versioning Scheme

The versioning scheme we follow is vX_Y, where X is the major version number and Y is the minor version number. Major version changes indicate significant changes in the API, such as breaking changes or major feature updates. Minor version changes indicate minor updates or additions to the API without any breaking changes.

How to Use Versioning

To use a specific version of the API, simply include the version number as a prefix in the endpoint URL. For example, to access the forecast endpoint in version 3.1, the URL would be: /v3_1/forecast/latitude/longitude. Ommitting the version number will default to version v3.0.

Upgrading to a New Version

We strive to support at least one version downward from the latest version of the API. However, older versions of the API may be shut down after a certain period of time to ensure proper maintenance and security. It's important to stay updated with our API documentation and changelog to ensure compatibility with the latest version of the API.

Deprecation Policy

As part of versioning, we may deprecate certain endpoints or features in older API versions. Deprecated endpoints or features will continue to work as before, but will be marked as deprecated and eventually terminated in future versions of the API. It's recommended to update your integrations to use the latest version of the API and avoid using deprecated endpoints or features to ensure uninterrupted access to the API functionality.

We strive to provide backward compatibility and minimize the impact of changes on existing integrations. However, it's important to thoroughly review the changelog and update your integrations accordingly when upgrading to a new version of the API.

Conclusion

API versioning allows us to make improvements and updates to the API while maintaining backward compatibility. By specifying the version number in the endpoint URL, you can ensure that your integrations continue to work as expected even when updates are made to the API. Please stay updated with our API documentation and changelog to keep track of version changes and deprecated features. If you have any questions or need further assistance, please don't hesitate to contact us.

Overview

To ensure secure access to our API, authentication is required for all requests. We use API keys as a means of authentication, which need to be included in the header of each API request. API keys are generated when you register for an account with us and are used to identify and authorize your API requests.

Authentication Process

To authenticate your API requests, you need to include the API key in the header of each request. The API key should be included in the x-api-key header. The format for including the API key in the header is as follows:

curl -X GET -H 'x-api-key: <API_KEY>' "https://forecast.meteonomiqs.com/forecast/48.1663/11.5683/"

Replace <API_KEY> with your actual API key value.

Obtaining an API Key

To obtain an API key, you can either register through our self service API portal or contact our sales team using info@meteonomiqs.com. Please note that API keys are unique to your account and should not be shared with others. It's important to keep your API key secure and not expose it in any public or unsecured environment.

If you have purchased our API through our API portal, you can find information on how to authenticate in the portal where you obtained your API key. Please refer to the documentation or help resources provided in the portal for instructions on how to include the API key in your API requests.

Including API Key in Requests

To include the API key in your API requests, you need to add the x-api-key header to your requests and set its value to the API key as described in the Authentication Process section above. Here's an example of how to include the API key in a cURL request:

curl -X GET -H 'x-api-key: <API_KEY>' "https://forecast.meteonomiqs.com/forecast/48.1663/11.5683/"

Replace <API_KEY> with your actual API key value and https://forecast.meteonomiqs.com/forecast/48.1663/11.5683/ with the actual API endpoint you want to access.

Handling Authentication Errors

If the API key is missing or invalid, you will receive an authentication error response indicating that the request is unauthorized. In such cases, please double-check the API key and ensure that it is included correctly in the header of your API requests.

Contact Us

If you have any questions or need further assistance with authentication or any other API-related issues, please don't hesitate to contact us at info@meteonomiqs.com. We're here to help!

Conclusion

In conclusion, API key authentication is a secure way to access our API and ensure that only authorized requests are processed. It's important to obtain and use your unique API key for authentication in all your API requests to ensure seamless and secure integration with our services.

The icon may vary depending on the time of the day, wind speed and weather warnings.

.svg	description	icon
d_x.svg	Icon displays weather state during day time
n_x.svg	Icon displays weather state during night time
d_e_x.svg	Icon displays weather state during day time with weather warning
n_e_x.svg	Icon displays weather state during night time with weather warning
d_w_x.svg	Icon displays weather state during day time with wind warning
n_w_x.svg	Icon displays weather state during night time with wind warning

Forecast

State	Short	Long	Icon
"-"	Unknown	Weather conditions unknown	none
0	Sunny	Uninterrupted sunshine, no clouds, blue sky
1	Slightly cloudy	Mostly blue skies, 1/8 to 3/8 of sky covered with clouds
2	Cloudy	4/8 to 6/8 of sky covered with clouds; sun visible intermittently
3	Overcast	7/8 to 8/8 of sky covered with clouds, no or very little sun, dry
4	Fog	Ground-level cloud, visibility below 1000 metres
5	Drizzle	Precipitation in liquid form with droplet size less than 0.6 mm
6	Rain	Precipitation in liquid form in an area >10km² and longer than 45 minutes (including intermittent precipitation), droplet size 0.6 to 3 mm
7	Snow	Precipitation in solid form, fine ice crystals
8	Showers	Convective precipitation in a confined area (<10 km²) with a maximum duration of 45 minutes, droplet size 0.6 to 3 mm
9	Thunderstorm	Lightning and thunder, usually accompanied by heavy rain, hail or gusts of wind; however, there are also dry thunderstorms.
10	Partly cloudy	Mostly blue skies, 1/8 to 3/8 of sky covered with clouds.
20	Cloudy	4/8 to 6/8 of sky covered with clouds; sun visible intermittently.
21	Cloudy	4/8 to 6/8 of sky covered with clouds; sun visible intermittently.
30	Overcast	7/8 to 8/8 of sky covered with clouds; no or very little sun, dry.
40	Fog	Ground-level cloud, visibility below 1000 metres.
45	Fog	Ground-level cloud, visibility below 1000 metres.
48	Fog with signs of frost	Ground-level cloud, visibility below 1000 metres, temperature below zero degrees, fog droplets freezing on objects (cars, trees, etc.)
49	Fog with signs of frost	Ground-level cloud, visibility below 1000 metres, temperature below zero degrees, fog droplets freezing on objects (cars, trees, etc.)
51	Light drizzle	Precipitation in liquid form with droplet size smaller than 0.6 mm, rainfall up to 0.2 litres/hour
55	Strong drizzle	Precipitation in liquid form with droplet size smaller than 0.6 mm, rainfall from 0.5 litres/hour
56	Slight drizzle, freezing	Precipitation in liquid form with droplet size smaller than 0.6 mm, rainfall up to 0.2 litres/hour, temperatures below zero degrees Celsius
57	Strong drizzle, freezing	Precipitation in liquid form with droplet size smaller than 0.6 mm, rainfall from 0.5 litres/hour, temperatures below zero degrees Celsius
60	Light rain	Precipitation in liquid form in an area >10km² and longer than 45 minutes (also with interruptions), droplet size 0.6 to 3 mm, rainfall up to 0.5 litres/hour
61	Light rain	Precipitation in liquid form in an area >10km² and longer than 45 minutes (also with interruptions), droplet size 0.6 to 3 mm, rainfall up to 0.5 litres/hour
63	Moderate rain	Precipitation in liquid form in an area >10km² and longer than 45 minutes (also with interruptions), droplet size 0.6 to 3 mm, rainfall between 0.5 and 4 litres/hour
65	Heavy rain	Precipitation in liquid form in an area >10km² and longer than 45 minutes (also with interruptions), droplet size 0.6 to 3 mm, rainfall more than 4 litres/hour
66	Light rain, freezing	Precipitation in liquid form in an area >10km² and longer than 45 minutes (also with interruptions), droplet size 0.6 to 3 mm, rainfall up to 0.5 litres/hour, temperatures <=0°C
67	Moderate or heavy rain, freezing	Precipitation in liquid form in an area >10km² and longer than 45 minutes (also with interruptions), droplet size 0.6 to 3 mm, rainfall up to or above 4 litres/hour, temperatures <=0°C
68	Light sleet	Precipitation in liquid and solid form, precipitation quantity up to 0.5 litres/hour
69	Heavy sleet	Precipitation in liquid and solid form, precipitation quantity more than 2 litres/hour
70	Light snowfall	Convective precipitation in solid form in a confined area (<10km²) with a maximum duration of 45 minutes, new snowfall less than 1 cm / hour
71	Light snowfall	Convective precipitation in solid form in a confined area (<10km²) with a maximum duration of 45 minutes, new snowfall less than 1 cm / hour
73	Moderate snowfall	Precipitation in solid form consisting of fine ice crystals, new snowfall between 1 and 4 centimetres/hour
75	Heavy snowfall	Precipitation in solid form consisting of fine ice crystals, new snowfall more than 4 centimetres/hour
80	Light showers	Convective precipitation in liquid form in a confined area (<10km²) with a maximum duration of 45 minutes, droplet size 0.6 to 3 mm, rainfall between 0.1 and 0.4 liters / 10min
81	Showers	Convective precipitation in liquid form in a confined area (<10km²) with a maximum duration of 45 minutes, droplet size 0.6 to 3 mm, rainfall between 0.2 and 2 liters / 10min
82	Heavy showers	Convective precipitation in liquid form in a confined area (<10km²) with a maximum duration of 45 minutes, droplet size 0.6 to 3 mm, rainfall more than 2 liters / 10min
83	Light snowfall/showers	Convective precipitation in liquid and solid form in a confined area (<10km²) with a maximum duration of 45 minutes, precipitation between 0.1 and 0.4 liters / hour
84	Heavy snowfall/showers	Convective precipitation in liquid and solid form in a confined area (<10km²) with a maximum duration of 45 minutes, precipitation exceeding 2 litres / hour
85	Light flurry of snow	Convective precipitation in solid form in a confined area (<10km²) with a maximum duration of 45 minutes, new snowfall less than 1 cm / hour
86	Moderate or heavy flurry of snow	Convective precipitation in solid form in a confined area (<10km²) with a maximum duration of 45 minutes, new snowfall more than 1 cm / hour
95	Light thunderstorm	Lightning and thunder, usually accompanied by heavy rain, hail or gusts of wind; low lightning frequency, longer intervals between individual discharges
96	Severe thunderstorm	Lightning and thunder, usually accompanied by heavy rain, hail or gusts of wind; high frequency of lightning, constant rolls of thunder
-1	n/a	Not specified: no observation was possible or no observation was transmitted

Observation

State	Text	Icon
0	Sunny
1	Slightly cloudy
2	Cloudy
3	Overcast
4	Fog
5	Drizzle
6	Rain
7	Snow
8	Showers
9	Thunderstorm
10	Slightly cloudy
20	Cloudy
30	Overcast
40	Fog
45	Fog
48	Fog with signs of frost
49	Fog with signs of frost
50	Drizzle
51	Light drizzle
53	Drizzle
55	Heavy drizzle
56	Slight drizzle, freezing
57	Heavy drizzle, freezing
60	Light rain
61	Light rain
63	Moderate rain
65	Heavy rain
66	Light rain, freezing
67	Moderate rain, freezing
68	Light sleet
69	Heavy sleet
70	Light snowfall
71	Light snowfall
73	Moderate snowfall
75	Heavy snowfall
80	Light showers
81	Showers
82	Heavy showers
83	Light showers
84	Heavy showers
85	Light snowfall
86	Moderate snowfall
95	Light thunderstorm
96	Severe thunderstorm
999	n/a

Moonphase

Moonzodiac

For both rain and snow.

This is a proprietary precipitation class that's used by some forecast endpoints.

List of response codes returned by wetter.com API

2xx Success

3xx Redirection

4xx Client errors

5xx Server errors

All endpoints for getting weather forecast from the API