IPMA's open data

Kept by incident.ipma@web-summit.dinis, 11 November 2026, 11:50 UTC. At Dinis Cruz's word (BRIEF.md, 11 November, ~02:10 UTC): "start a new agent for IPMA and build a complete new visualisation, a section, a data analysis ... every JSON under api.ipma.pt/open-data, the cities, the ocean".

Not a warning service. Everything here is IPMA's, shown as IPMA's, with the time we read it; we add no forecast and no advice. Follow IPMA and ANEPC.

IPMA's open data · Warnings over time · Stations · The sea · Cities: forecast and observed · The API, mapped · What we learned · Browse the files · Licence and terms

What this is. IPMA (Instituto Português do Mar e da Atmosfera) publishes warnings, forecasts, observations, the sea state, earthquakes and climate series as open files at api.ipma.pt. This section maps every one of them, reads them about once an hour (one request every few seconds, read-only), keeps the sha256 and the time of each read in git and the full responses in a data store, records what changed between reads, and draws views from them. The map above is drawn from IPMA's coordinates only: no tiles, no image.

Everything on this page is a fact in this site's sense: read from the body that warns (IPMA), with the file and the UTC time we read it. Where a figure is computed by us (a 24-hour sum, the nearest station), the page and the data say so.

Now, in IPMA's feed

Read 2026-11-11 11:47 UTC (IPMA's file dated 2026-11-11 11:15 UTC): 51 warnings above green across 22 of 25 areas; 9 red, 25 orange, 17 yellow. All of them, over time.

Source: warnings_www.json. Windows are as IPMA writes them (no zone; Lisbon and Madeira are on UTC in November).

What IPMA publishes

29 data sets: 20 documented at api.ipma.pt, 9 more found in its own directory listings. 64 files read in the latest pass (2026-11-11 11:47 UTC: 64 requests in 189 s). The full map, field by field: api.md and api.json.

Warnings

Forecasts

The sea

Observations

Earthquakes

Climate, by municipality

Id tables and files

Listed, not documented

What the documentation does not match or does not say

Found by reading the responses beside the documentation (11 November 2026). Observations of ours about IPMA's files, each checkable at the address given on the data set's page.

• Daily forecast up to 5 days, by place, precipitaProb: the documentation names this field probPrecipita; the responses carry precipitaProb
• Daily forecast up to 3 days, all places for one day, precipitaProb: the documentation names this field probPrecipita; the responses carry precipitaProb
• Seismic events, last 30 days, lon: the documentation names this field long; the responses carry lon
• Shellfish harvesting bans by production zone, code: the documentation names this field samp; the responses carry code
• Wind strength classes, descClassWindSpeedDailyEN: documented as descClassWindSpeedEN
• Wind strength classes, descClassWindSpeedDailyPT: documented as descClassWindSpeedPT
• Weather symbols (SVG, zipped): Documented at this address, which answered 404 Not Found on 11 November 2026 (02:11 UTC). IPMA's own directory lists the file under another name, ending concelhos-20d.csv: see "Daily reference evapotranspiration by municipality (the address IPMA's directory lists)". The reader keeps asking both and records each answer.
• Daily reference evapotranspiration by municipality (the address IPMA's directory lists): The file as IPMA's directory lists it. The documentation gives the name with "20d" and "concelhos" the other way round, and that address answers 404.
• Climate series by district: reference evapotranspiration: Listed in IPMA's directory, not in the documentation. Eighteen folders, one per mainland district. The files are not downloaded yet: the names, sizes and dates IPMA lists are in listing.json.
• Climate series by district: a drought index (the folder is named mpdsi): Listed in IPMA's directory, not in the documentation. Eighteen folders, one per mainland district. The files are not downloaded yet: the names, sizes and dates IPMA lists are in listing.json.
• Climate series by district: total precipitation: Listed in IPMA's directory, not in the documentation. Eighteen folders, one per mainland district. The files are not downloaded yet: the names, sizes and dates IPMA lists are in listing.json.
• Climate series by district: maximum temperature: Listed in IPMA's directory, not in the documentation. Eighteen folders, one per mainland district. The files are not downloaded yet: the names, sizes and dates IPMA lists are in listing.json.
• Climate series by district: minimum temperature: Listed in IPMA's directory, not in the documentation. Eighteen folders, one per mainland district. The files are not downloaded yet: the names, sizes and dates IPMA lists are in listing.json.
• Monthly and daily long series (spreadsheets), Lisbon from 1855: Listed in IPMA's directory, not in the documentation. Binary spreadsheets: not downloaded; a vault could hold them if Dinis wants them read.
• A list of place ids for district 06 (Coimbra): Listed in IPMA's directory (dated 27 February 2018), not in the documentation. Its "data" is a set of bare numbers in braces, which is not valid JSON.
• zonas.gpkg (a GeoPackage, 61 MB as listed): Listed in IPMA's directory (dated 19 June 2024), not in the documentation. Not downloaded: only its headers are read.

• Weather warnings, up to 3 days: no time of issue: a row does not say when the warning was issued or changed (the file's Last-Modified header is the nearest thing)
• Weather warnings, up to 3 days: the time zone of startTime and endTime (the documentation says forecasts are in UTC; for warnings it says nothing)
• Weather warnings, up to 3 days: the areas MCN, MRM (in the feed) are in no id table: distrits-islands.json has MCS and MPS only
• Weather warnings, up to 3 days: no identifier for a warning: a changed warning is a different row, not an update of the same one
• Daily forecast up to 5 days, by place: tMin and tMax are strings with one decimal here and whole numbers in the day files
• Daily forecast up to 5 days, by place: which model run a file comes from (dataUpdate is the file's rewrite time, hourly)
• Daily forecast up to 3 days, all places for one day: 27 places are listed here; distrits-islands.json lists 35
• Sea state forecast up to 3 days, by day: which wave model and run
• Ultraviolet index forecast: the title says up to 3 days; the file read on 11 November carried 4 days
• Ultraviolet index forecast: intervaloHora was empty in every row read
• Fire risk forecast up to 3 days, by municipality: what the point of each municipality is (a centroid, the seat, a station)
• Station observations, hourly, last 24 hours: the hour label's convention: whether a label is the hour starting or ending at that time, and its time zone (incident.meteorologist@ infers hour ending, UTC: incidents/2026-11-10-storm-charles/data/weather/madeira.json, hour_label)
• Station observations, hourly, last 24 hours: no gusts: wind is the mean speed only; warnings are issued on gusts
• Station observations, hourly, last 24 hours: a station can be null or absent in an hour
• Station observations, last 3 hours, with coordinates: the hour label's convention, as for observations.json
• Seismic events, last 30 days: the unit of depth
• Seismic events, last 30 days: sensed, sismoId, shakemapid, shakemapref, googlemapref, tensorRef, source, updateDate, lastSismicActivityDate
• Daily precipitation by municipality: the mainland only (the file name says continental)
• Daily air temperature by municipality: the mainland only (the file name says continental)
• Daily reference evapotranspiration by municipality: the mainland only (the file name says continental)
• Weather stations: altitude, district, the instruments at each station, the owner of the station
• Wind strength classes: the speeds each class stands for
• Precipitation intensity classes: the amounts each class stands for

The files of this section

For agents: every file above is JSON at a stable address; each derived file names the IPMA file it came from, its sha256 and the time read.