The Public Weather API (PWA) is the RESTful API supplied by the Meteonomiqs team at wetter.com.

The base URL of all endpoints is: https://forecast.meteonomiqs.com/<version> (where <version> is the API version, see below for more information).

The endpoints are grouped in the following distinct categories with respective URL suffixes:

Path parameters can be generally summarized by the following two options:

• Get X by coordinates
• Get X by location

Where X is something like forecast, pollen, warnings, etc.

“Coordinates” refers to latitude / longitude coordinates e.g. 52.509,13.376 = Potsdamer Platz, Berlin.

“Location” refers to country code with a postcode / Postleitzahl / zip-code e.g. DE + 10785 for Potsdamer Platz again.

Other endpoints can have more specific parameters, for example, you can fetch specific warning details using the warning ID which can be obtained from MeteoAlarm.

Data is returned in JSON format for each API request.

An abbreviated sample from the “get nowcast weather forecast by coordinates” endpoint is as follows:

{
    "precipitationRisk": {
        "fingerprint": "20260319143500:-123.152000:49.283000:0:0",
        "precType": null,
        "items": [],
        "text": null,
        "times": {
            "startTime": null
        }
    },
    "realtimeWeather": {
        "items": [
            {
                "date": "2026-03-19",
                "from": "2026-03-19T14:35:00Z",
                "to": "2026-03-19T14:40:00Z",
                "isNight": false,
                "hasWarnings": false,
                "cloudsTotal": 8,
                "temperature": {
                    "value": 10,
                    "unit": "°C"
                },
                "weather": {
                    "state": 60,
                    "text": "Leichter Regen",
                    "icon": "d_60.svg"
                }
            },
            ...
        ]
    }
}

More detailed documentation exists for each endpoint under the 200 OK response schemas underneath the parameter description.

PWA supports multiple languages across all the endpoints and selecting the language is done via the Accept-Language header variable.

For example, to select American English as a language, add the following header to your HTTP request: Accept-Language: en-US.

Curl example:

curl --location 'https://forecast.meteonomiqs.com/v4_0/forecast/-25.30066/-57.63591/' --header 'x-api-key: <api-token>’ --header 'Accept-Language: en-US'

The default language across all endpoints is German (AKA de-DE). This is also the case when the Accept-Language header is missing, malformed, or the language is not supported.

Supported locals + languages:

• de-DE
• de-AT
• de-CH
• en-US
• en-GB
• fr-FR
• it-IT
• pl-PL
• es-ES
• cs-CZ
• da-DK
• nl-NL
• ro-RO
• sk-SK
• sv-SE

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., v4_0) 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: /v4_0/forecast/latitude/longitude. Ommitting the version number will default to version v4.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

Contact our sales team using info@meteonomiqs.com to obtain an API key. 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

Endpoints for weather forecasts up to 14 days in advance, with various aggregation intervals.