There have been many changes and upgrades between v3.1 and v4.0 to improve the user experience and provide more relevant, and accurate forecasts.

To get started with transitioning over from v3.1 to v4.0, you can start by replacing the v3_1 in the URLs with v4_0 and comparing the outputs.

From:

curl --location 'https://forecast.meteonomiqs.com/v3_1/forecast/48.1374/10.5753/' \
--header 'x-api-key: <api-token>' \
--header 'Accept-Language: de-de'

To:

curl --location 'https://forecast.meteonomiqs.com/v4_0/forecast/48.1374/10.5753/' \
--header 'x-api-key: <api-token>' \
--header 'Accept-Language: de-de'

Please note: effort was made to make sure that the v4.0 endpoints matched the v3.1 endpoints as closely as possible. However, there are still some breaking changes between the versions. Please refer to this changelog and test all applications with the new endpoints thoroughly before deployment to ensure that no key functionality is missing.

Starting with a basic overview of major changes.

• A new version is now required for the URL: v4_0
• pollenwcom has been renamed to just pollen
• A number of endpoints have had their names in the documentation changed to make them a little clearer:

Tag	Old name	New name
Forecast	"Get Forecast" (with latitude and longitude)	"Get forecast by coordinates"
Forecast	"Get Forecast" (with countryCode and postCode)	"Get forecast by location"
Forecast	"Get Forecast Summary"	"Get forecast summary by coordinates"
Forecast	"Get Forecast Spaces"	"Get forecast spaces by coordinates"
Forecast	"Get Forecast Hourly"	"Get hourly forecast by coordinates"
Forecast2	"Get Forecast"	"Get forecast2 by coordinates"
Warnings	"Warnings endpoints"	"Get active warnings by coordinates"
Nowcast	"Get observation with realtime weather, precipitation risk and station data when available"	"Get nowcast weather forecast by coordinates"
Locations	"Location by coordinates"	"Get nearby location by coordinates"

• A number of endpoints have been removed:

Tag	Endpoint	Reason
Warnings	"Warnings regions endpoints"	Redundant, information already supplied by "Get active warnings by coordinates"
Warnings	"Warnings ID endpoints"	Redundant, information already supplied by "Get active warnings by coordinates"
Hood	(all endpoints)	New backend data structure means output would have been identical to Pollen and Forecast endpoints. Have been replaced with those endpoints. Station data is also no longer returned
Nowcast	"Get pollen forecast"	New backend data structure means output would have been identical to Pollen endpoints. Has been replaced with that endpoint

• The nearby locations endpoint has had its URL spell-checked and replaced:
  • Old: /locations/nearBy/{latitude}/{longitude}
  • New: /locations/nearby/{latitude}/{longitude}
• A new HTTP 406 response type has been added for "Not Acceptable" requests. This will be returned when the request is valid but doesn't conform to the specific request format
• Sending requests to non-existent endpoints will now return a 404 response instead of the previous 403 and clarify: Resource not found
• Summary and space items in the Forecast tagged requests (i.e. under summary and morning/afternoon) have now been standardised and return the same format response
• Maximums, minimums, and averages (AKA means) are now standardised and are all called max, min, and avg respectively. All have the number type and are nullable
• All values returned are now assumed to be nullable - if a returned value is null, then there is currently no data for that value for the given request
• All clouds values are still returned as percentages, but are now transformed from oktas, which means all percentages will be a multiple of 12.5 due to that being 1/8th of 100
• All latitude / longitude coordinate pairs are rounded to 3 decimal points in the backend - returned coordinate pairs will reflect this
• The forecast range of some values have changed, when the forecast model doesn't have data beyond a given point in a forecasting period, it will return null for the value e.g. uv_index in Forecast2

Below is a more detailed list about the changes to the API endpoints.

Get forecast by coordinates (and location): GET /forecast/{latitude}/{longitude} (GET /forecast/byLocation/{countryCode}/{postCode})

Each of the changes in summary, spaces, and hourly are the same as in their respective limited API endpoints.

summary

Renamed:

• Renamed rainHours to rainyHours
• Renamed wind.significationWind to wind.significantWind
• Renamed pressure.mean to pressure.avg
• Renamed relativeHumidity.mean to relativeHumidity.avg
• Renamed clouds.mean to clouds.avg

Removed:

• Removed dateWithTimezone - use date for the date and from and to for the UTC times instead
• Removed weatherNg - use weather instead
• Removed snowHeight - deprecated
• Removed freshSnow and replaced with the range prec.freshSnowRangeMin (minimum) and prec.freshSnowRangeMax (maximum)
• Removed snowLine.avg and snowLine.unit
• Removed windchill.avg - deprecated, use range instead

spaces

Forecast for spaces has been extended from 10 to 16 days.

Renamed:

• Renamed <space>.rainHours to <space>.rainyHours
• Renamed <space>.wind.significationWind to <space>.wind.significantWind
• Renamed <space>.pressure.mean to <space>.pressure.avg
• Renamed <space>.relativeHumidity.mean to <space>.relativeHumidity.avg
• Renamed <space>.clouds.mean to <space>.clouds.avg

Removed:

• Removed forenoon - deprecated
• Removed <space>.weatherNg - use <space>.weather instead
• Removed <space>.snowHeight - deprecated, previously null
• Removed <space>.freshSnow and replaced with the range <space>.prec.freshSnowRangeMin (minimum) and <space>.prec.freshSnowRangeMax (maximum)
• Removed <space>.snowLine.avg and <space>.snowLine.unit - use range instead
• Removed <space>.wind.mean - use wind.avg instead
• Removed <space>.windchill.avg - use range instead

hourly

Added:

• Added dateWithTimezone - end of the hour in UTC time
• Added from and to - indicates start and end times of forecast in UTC

Changed:

• Changed snowLine to prec.snowLine and is now a single value instead of an object
• Changed windchill to only return a number

Renamed:

• Renamed wind.significationWind to wind.significantWind
• Renamed wind.mean to wind.avg

Removed:

• Removed rainHours - deprecated, use weather instead for weather conditions

Get forecast summary by coordinates: GET /forecast/{latitude}/{longitude}/summary

Renamed:

• Renamed rainHours to rainyHours
• Renamed wind.significationWind to wind.significantWind
• Renamed pressure.mean to pressure.avg
• Renamed relativeHumidity.mean to relativeHumidity.avg
• Renamed clouds.mean to clouds.avg

Removed:

• Removed dateWithTimezone - use date for the date and from and to for the UTC times instead
• Removed weatherNg - use weather instead
• Removed snowHeight - deprecated, previously null
• Removed freshSnow and replaced with the range prec.freshSnowRangeMin (minimum) and prec.freshSnowRangeMax (maximum)
• Removed snowLine.avg and snowLine.unit
• Removed windchill.avg - deprecated, use range instead

Get hourly forecast by coordinates: GET /forecast/{latitude}/{longitude}/hourly

Added:

• Added dateWithTimezone - start of the hour in UTC time
• Added from and to - indicates start and end times of forecast in UTC
• Added prec.freshSnowRangeMin and prec.freshSnowRangeMax to indicate min and max fresh snow lines
• Added dewpoint to indicate the dewpoint temperature

Changed:

• Changed snowLine to prec.snowLine and is now a single value instead of an object
• Changed windchill to only return a number

Renamed:

• Renamed wind.significationWind to wind.significantWind
• Renamed wind.mean to wind.avg

Removed:

• Removed rainHours - deprecated, use weather instead for weather conditions

Get forecast spaces by coordinates: GET /forecast/{latitude}/{longitude}/spaces

Forecast for spaces has been extended from 10 to 16 days.

Renamed:

• Renamed <space>.rainHours to <space>.rainyHours
• Renamed <space>.wind.significationWind to <space>.wind.significantWind
• Renamed <space>.pressure.mean to <space>.pressure.avg
• Renamed <space>.relativeHumidity.mean to <space>.relativeHumidity.avg
• Renamed <space>.clouds.mean to <space>.clouds.avg

Removed:

• Removed forenoon - deprecated
• Removed <space>.weatherNg - use <space>.weather instead
• Removed <space>.snowHeight - deprecated, previously null
• Removed <space>.freshSnow and replaced with the range <space>.prec.freshSnowRangeMin (minimum) and <space>.prec.freshSnowRangeMax (maximum)
• Removed <space>.snowLine.avg and <space>.snowLine.unit
• Removed <space>.wind.mean - use wind.avg instead
• Removed <space>.windchill.avg - use range instead

Get nearby location by coordinates: GET /locations/nearby/{latitude}/{longitude}

Fixed:

• Double prefixing of country and state in items.admin1.location.slug

Renamed:

• Renamed items.zipCodes to items.zipcodes
• Renamed scores.seo_priority to scores.seoPriority - standardising value name styles in endpoint

Removed:

• Removed pagination - deprecated, previously only null
• Removed items.iso2 - deprecated, previously only null
• Removed items.isoPath - deprecated, previously only null
• Removed items.liesIn - deprecated, previously only had one value skiareas which was always null
• Removed items.nameTranslations - deprecated, previously only an empty list
• Removed items.searchContext - deprecated, previously only null
• Removed items.warnregions - deprecated, previously only null

Get nowcast weather by coordinates: GET /nowcast/weather/{latitude}/{longitude}

Added:

• Added precipitationRisk.items.precType to indicate the time of precipitation
• Added temperature.value to indicate single temperature value for the period
• Added to and from to both precipitationRisk and realtimeWeather items arrays to indicate forecast window in UTC time
• Added precipitationRisk.items.times.startTime to indicate when the precipitation event started

Changed:

• Changed items.date to be just the date in YYYY-MM-DD format and display local date, if you were using this field for the datetime, please use items.from instead
• Changed precipitationRisk.items.radar.value to represent a new classification which is available under the Nowcast Radar Values section in the References. The old classification was as follows: 0 = no data, 1 = no rain / snow fall, 2 - 7 = increasing rain intensity, 12 - 17 = increasing snow intensity

Removed:

• Removed station - deprecated, nearly all values were null for the object
• Removed precipitationRisk.items.isRain - deprecated, previously only null
• Removed precipitationRisk.items.items.radar.isRain - deprecated, use drizzlePossible instead
• Removed precipitationRisk.items.run - deprecated
• Removed precipitationRisk.items.items.weather.shortText - deprecated, this information is also present in radar
• Removed realtimeWeather.items.temperature.min, realtimeWeather.items.temperature.max, and realtimeWeather.items.temperature.avg - single value now for 5 minute intervals (value)
• Removed realtimeWeather.items.fingerprint - deprecated, only one fingerprint at root level now
• Removed realtimeWeather.items.run - deprecated
• Removed realtimeWeather.items.source - deprecated, previously only hood, and that source isn't listed any more
• Removed realtimeWeather.items.items.weather.shortText - deprecated, same output as longText
• Removed realtimeWeather.items.weather.stateNew - deprecated, due to being duplication of state

Get pollen forecast by coordinates (and location): GET /pollen/byCoordinates/{latitude}/{longitude} (GET /pollen/byLocation/{countryCode}/{postCode})

Changed:

• Changed URL to use pollen instead of pollenwcom
• Changed daily.items.pollen_forecast pollen names to lowercase and removed all spaces in pollen names. Please refer to the pollen mapping table
• Changed daily.items.pollen_index to be an integer type instead of a stringified integer

Renamed:

• Renamed daily.items.pollen-forecast to daily.items.pollen_forecast

Removed:

• Removed zip-code - deprecated, zip code information is no longer returned by the API
• Removed release_date - deprecated
• Removed copyright - deprecated, no longer returned by the API

Get active warnings by coordinates: GET /warnings/{latitude}/{longitude}

Added:

• Added activeWarnings.severityInt - numerical severity value, scales with severity linearly from 1-4

Changed:

• Changed activeWarnings.onset and activeWarnings.expires to be in UTC time
• Changed activeWarnings.parameters to only return an empty dictionary for the time being - this data is still being implemented for the new backend and this value will be updated once the data is available

Removed:

• Removed activeWarnings.description - deprecated, previously null
• Removed activeWarnings.effective - deprecated, use onset instead
• Removed activeWarnings.headline - deprecated, previously null
• Removed activeWarnings.identifier - deprecated, use code instead
• Removed activeWarnings.instruction - deprecated, previously null
• Removed activeWarnings.msgType - deprecated, previously null
• Removed activeWarnings.references - deprecated, use code instead
• Removed activeWarnings.sent - deprecated, information no longer supplied by backend

Get forecast2 by coordinates: GET /forecast2/{latitude}/{longitude}

Added:

• Added parameters object with frequency value to indicate hourly / daily depending on whether that parameter was used as part of the request, not included in response if neither is used
• Added frequency.hourly.datetime_utc and frequency.hourly.datetime_local to indicate both the UTC and local datetimes of the forecast (this replaces the old frequency.hourly.datetime parameter)

Changed:

• Changed parameters.weather_state_text.value and parameters.wind_direction_text.value to return values in German, to standardise the language across the entire API

Renamed:

• Renamed frequency.daily.parameters.temperature.minimum to frequency.daily.parameters.temperature.min
• Renamed frequency.daily.parameters.temperature.maximum to frequency.daily.parameters.temperature.max
• Renamed frequency.daily.parameters.wind_speed.minimum to frequency.daily.parameters.wind_speed.min
• Renamed frequency.daily.parameters.wind_speed.maximum to frequency.daily.parameters.wind_speed.max
• Renamed frequency.daily.parameters.relative_humidity.minimum to frequency.daily.parameters.relative_humidity.min
• Renamed frequency.daily.parameters.relative_humidity.maximum to frequency.daily.parameters.relative_humidity.max
• Renamed frequency.daily.parameters.relative_humidity.mean to frequency.daily.parameters.relative_humidity.avg
• Renamed frequency.daily.parameters.sea_level_pressure.minimum to frequency.daily.parameters.sea_level_pressure.min
• Renamed frequency.daily.parameters.sea_level_pressure.maximum to frequency.daily.parameters.sea_level_pressure.max
• Renamed frequency.daily.parameters.sea_level_pressure.mean to frequency.daily.parameters.sea_level_pressure.avg
• Renamed frequency.daily.parameters.cloud_coverage.minimum to frequency.daily.parameters.cloud_coverage.min
• Renamed frequency.daily.parameters.cloud_coverage.maximum to frequency.daily.parameters.cloud_coverage.max
• Renamed frequency.daily.parameters.cloud_coverage.mean to frequency.daily.parameters.cloud_coverage.avg

Removed:

• Removed frequency.daily.parameters.temperature.mean - deprecated, use value range instead
• Removed frequency.daily.parameters.wind_speed.mean - deprecated, use value range instead
• Removed frequency.hourly.parameters.surface_pressure - deprecated, use pressure instead
• Removed frequency.hourly.parameters.slippery_roads_index - deprecated, no longer in use
• Removed frequency.hourly.datetime - please use either frequency.hourly.datetime_utc or frequency.hourly.datetime_local instead

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

Number	English description	German Description
1	New Moon	Neumond
2	Waxing Crescent	Zunehmender Sichelmond
3	First Quarter	Zunehmender Halbmond
4	Waxing Gibbous	Zunehmender Dreiviertelmond
5	Full Moon	Vollmond
6	Waning Gibbous	Abnehmender Dreiviertelmond
7	Last Quarter	Abnehmender Halbmond
8	Waning Crescent	Abnehmender Sichelmond

Moonzodiac

Number	English Description	German Description
1	Aries	Widder
2	Taurus	Stier
3	Gemini	Zwillinge
4	Cancer	Krebs
5	Leo	Löwe
6	Virgo	Jungfrau
7	Libra	Waage
8	Scorpio	Skorpion
9	Sagittarius	Schütze
10	Capricorn	Steinbock
11	Aquarius	Wassermann
12	Pisces	Fische

For both rain and snow.

Number	Description
0	kein Niederschlag
1	Leichter Niederschlag / Schneefall möglich
2	niedrig
3	leicht
4	mäßig
5	mäßig oder schwer
6	intensiv
7	sehr schwer
8	extrem
9	extrem / Hagel möglich

List of response codes returned by wetter.com API

2xx Success

Status Code	Status Message
200	OK
204	No Content

3xx Redirection

'Status Code	Status Message
301	Moved Permanently
304	Not Modified

4xx Client errors

Status Code	Status Message
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found
405	Method Not Allowed
406	Not Acceptable
409	Conflict
429	Too Many Requests

5xx Server errors

Status Code	Status Message
500	Internal Server Error

All forecast endpoints