# MeteoAlarm European Weather Warnings API

> MeteoAlarm: official weather warnings for 39 European countries in CAP format, levels and regions

- Vendor: `meteoalarmeuropeanweatherwarni` · version 1.0 · category Weather · tags meteoalarm api, weather warnings api, europe weather alerts api, cap alerts api, severe weather api, storm warnings api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/meteoalarmeuropeanweatherwarni
- This document: https://apiclay.com/docs/meteoalarmeuropeanweatherwarni.md
- OpenAPI 3.1: https://apiclay.com/api/meteoalarmeuropeanweatherwarni/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `meteoalarmeuropeanweatherwarni`
- Updated: 2026-11-18

## About

## MeteoAlarm European Weather Warnings API

MeteoAlarm, the warning system of Europe's national weather services: every active weather warning for one country as Common Alerting Protocol alerts (event such as wind, rain, snow, thunderstorm or heat, severity, urgency and certainty, onset and expiry, headline, description and instructions in the local languages and English, and the warned areas with their codes); the 39 member countries with their codes and bounding boxes; and the warning levels with their colours.

Data comes from **meteoalarm.org** (https://meteoalarm.org). Every route calls the source's own public API and returns it unchanged.

Typical flow: `POST /regions` for the countries, then `POST /warnings` with the body `{"country": "austria"}`.

### Routes

#### POST `/warnings` - Warnings
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| country | body | string | yes | Country name in lower case with hyphens, e.g. `austria`, `germany`, `united-kingdom`. |

Returns: `warnings` array, each `uuid` and `alert` (CAP): `identifier`, `sender`, `sent`, `status`, `msgType`, `scope`, `incidents` and `info` per language: `event`, `category`, `severity`, `urgency`, `certainty`, `onset`, `effective`, `expires`, `headline`, `description`, `instruction`, `senderName`, `parameter` (awareness level and type), `area` (`areaDesc`, `geocode`).

#### POST `/regions` - Regions
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| language | query | string | no | Label language, e.g. `en`. |

Returns: `regions` array: `code`, `name`, `active`, `bb` (bounding box), `meta.lastUpdated`.

#### POST `/levels` - Levels
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| language | query | string | no | Label language, e.g. `en`. |

Returns: `levels` array: `id`, `name`, `label`, `color`, `rank` and `labelMulti` (label per language).

### Caveats

- Large countries carry thousands of warnings: Germany's feed is about 6 MB and can take 30 seconds.
- Warnings come from the national weather services; credit MeteoAlarm and the issuing service when you republish them.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by meteoalarm.org.

## Pricing

- Pay as you go: 0.01 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### POST /warnings — Warnings
- Gateway: `POST https://api.apiclay.com/v1/api/meteoalarmeuropeanweatherwarni/warnings`
- Public body fields: `country` (string, required)
- Body sample (JSON):

```json
{
  "country": "<country>"
}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 10 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /regions — Regions
- Gateway: `POST https://api.apiclay.com/v1/api/meteoalarmeuropeanweatherwarni/regions`
- Public query params: `language` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /levels — Levels
- Gateway: `POST https://api.apiclay.com/v1/api/meteoalarmeuropeanweatherwarni/levels`
- Public query params: `language` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X POST "https://api.apiclay.com/v1/api/meteoalarmeuropeanweatherwarni/warnings" \
  -H "token: <YOUR_APICLAY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{ "country": "<country>" }'
```

Index of every published API: https://apiclay.com/llms.txt
