IPMA

App · 11 actions

Get Portugal's official weather from IPMA, the national weather and sea institute: 5-day forecasts, weather warnings, live readings from weather stations, sea, UV and fire risk forecasts, and recent earthquakes, for mainland Portugal, Madeira and the Azores. No account or API key required.

Actions

ActionWhat it does
Get 5-day forecastGet the weather forecast for one place for the next five days: the weather in words, lowest and highest temperature, chance and strength of rain, and the wind's direction and strength.
Get fire risk forecastGet the rural fire risk forecast for mainland Portugal's municipalities for today, tomorrow or the day after, from low to maximum, the highest first.
Get forecast for every locationGet one day's weather forecast for every place IPMA forecasts for (today, tomorrow or the day after), optionally only in one region: the weather in words, temperatures, rain and wind.
Get latest observationsGet the latest hourly reading of IPMA's weather stations: temperature, humidity, pressure, wind, rain and sunshine, for the stations you choose or every station in a region.
Get recent earthquakesGet the earthquakes IPMA recorded in the last 30 days in mainland Portugal, Madeira or the Azores, newest first: time, magnitude, depth, place and whether and where people felt it.
Get sea forecastGet the sea forecast for the coast of mainland Portugal, Madeira and the Azores for today, tomorrow or the day after: wave and swell height, swell period, wave direction and sea temperature.
Get station's last 24 hoursGet one weather station's hourly readings for up to the last 24 hours, newest first: temperature, humidity, pressure, wind, rain and sunshine.
Get UV index forecastGet the forecast UV index for the next five days, for every place IPMA covers or one place, with what it means (low to extreme).
Get weather warningsGet IPMA's weather warnings for the next three days: for each district or island area, what the warning is for (wind, rain, heat and so on), its level (yellow, orange or red), when it starts and ends, and IPMA's description in Portuguese.
List forecast locationsList the places IPMA forecasts for: the district capitals, the island towns of Madeira and the Azores and a few others, each with its id, district, municipality and weather warning area.
List weather stationsFind IPMA's weather stations by name or region, with each one's id and position, for the observation actions.

Get 5-day forecast

Get the weather forecast for one place for the next five days: the weather in words, lowest and highest temperature, chance and strength of rain, and the wind's direction and strength.

Inputs

LocationlocationtextRequired
The place to forecast. Pick it from the list, or give its name (e.g. Lisboa) or IPMA id (e.g. 1110600).

Outputs

countnumber
How many days are listed, usually 5.
dayslist
One forecast per day, from today.
latitudenumber
Latitude in decimal degrees.
location_idtext
IPMA's id for the place, e.g. '1110600' for Lisboa.
location_nametext
The place's name.
longitudenumber
Longitude in decimal degrees (negative is west).
regiontext
Mainland, Madeira or Azores.
summarytext
One line with the place and the first day's forecast.
updated_attext
When IPMA last updated this forecast (ISO 8601, UTC).
Example output
{
  "count": 5,
  "days": [
    {
      "date": "2026-11-02",
      "max_temperature_c": 25.9,
      "min_temperature_c": 14.1,
      "rain_intensity": null,
      "rain_probability_percent": 0.0,
      "weather": "Clear sky",
      "wind_direction": "NW",
      "wind_direction_name": "Northwest",
      "wind_strength": "Light"
    },
    {
      "date": "2026-11-03",
      "max_temperature_c": 22.2,
      "min_temperature_c": 11.2,
      "rain_intensity": null,
      "rain_probability_percent": 0.0,
      "weather": "Partly cloudy",
      "wind_direction": "NE",
      "wind_direction_name": "Northeast",
      "wind_strength": "Light"
    },
    {
      "date": "2026-11-04",
      "max_temperature_c": 20.0,
      "min_temperature_c": 9.9,
      "rain_intensity": null,
      "rain_probability_percent": 0.0,
      "weather": "Clear sky",
      "wind_direction": "NE",
      "wind_direction_name": "Northeast",
      "wind_strength": "Light"
    },
    {
      "date": "2026-11-05",
      "max_temperature_c": 18.9,
      "min_temperature_c": 8.9,
      "rain_intensity": null,
      "rain_probability_percent": 0.0,
      "weather": "Partly cloudy",
      "wind_direction": "NW",
      "wind_direction_name": "Northwest",
      "wind_strength": "Light"
    },
    {
      "date": "2026-11-06",
      "max_temperature_c": 19.7,
      "min_temperature_c": 9.5,
      "rain_intensity": null,
      "rain_probability_percent": 35.0,
      "weather": "Partly cloudy",
      "wind_direction": "S",
      "wind_direction_name": "South",
      "wind_strength": "Light"
    }
  ],
  "latitude": 38.766,
  "location_id": "1110600",
  "location_name": "Lisboa",
  "longitude": -9.1286,
  "region": "Mainland",
  "summary": "5-day forecast for Lisboa. 2026-11-02: Clear sky, 14.1 to 25.9 \u00b0C, 0% chance of rain.",
  "updated_at": "2026-11-02T17:31:02Z"
}

Get fire risk forecast

Get the rural fire risk forecast for mainland Portugal's municipalities for today, tomorrow or the day after, from low to maximum, the highest first.

Inputs

Daydaytext
Which day's forecast: today, tomorrow or the day after. Defaults to today.One of: today, tomorrow, day_after_tomorrow (The day after tomorrow). Default: today.
Districtdistricttext
Only municipalities in this district. Leave blank for all.One of: 01 (Aveiro), 02 (Beja), 03 (Braga), 04 (Bragança), 05 (Castelo Branco), 06 (Coimbra), 07 (Évora), 08 (Faro), 09 (Guarda), 10 (Leiria), and 8 more.
Municipalitiesmunicipalitieslist
Only these municipalities. Leave blank for all.One or more of: 1401 (Abrantes (Santarém)), 0101 (Águeda (Aveiro)), 0901 (Aguiar da Beira (Guarda)), 0701 (Alandroal (Évora)), 0102 (Albergaria-a-Velha (Aveiro)), 0801 (Albufeira (Faro)), 1501 (Alcácer do Sal (Setúbal)), 1402 (Alcanena (Santarém)), 1001 (Alcobaça (Leiria)), 1502 (Alcochete (Setúbal)), and 268 more.
Lowest riskminimum_risktext
Only municipalities at this risk or higher. Leave blank for every risk.One of: 1 (Low or higher), 2 (Moderate or higher), 3 (High or higher), 4 (Very high or higher), 5 (Maximum).

Outputs

countnumber
How many rows are listed.
datetext
The day the forecast is for (YYYY-MM-DD).
model_run_datetext
The day of the forecast run it comes from (YYYY-MM-DD).
municipalitieslist
Each mainland municipality's fire risk, the highest first.
summarytext
One line with the day and the highest risk.
updated_attext
When IPMA last updated this forecast (ISO 8601, UTC).
Example output
{
  "count": 7,
  "date": "2026-11-02",
  "model_run_date": "2026-11-01",
  "municipalities": [
    {
      "district": "Faro",
      "latitude": 37.3169,
      "longitude": -8.8028,
      "municipality": "Aljezur",
      "municipality_code": "0803",
      "risk": "Very high",
      "risk_level": 4
    },
    {
      "district": "Faro",
      "latitude": 37.1397,
      "longitude": -8.0202,
      "municipality": "Loul\u00e9",
      "municipality_code": "0808",
      "risk": "Very high",
      "risk_level": 4
    },
    {
      "district": "Faro",
      "latitude": 37.32,
      "longitude": -8.56,
      "municipality": "Monchique",
      "municipality_code": "0809",
      "risk": "Very high",
      "risk_level": 4
    },
    {
      "district": "Faro",
      "latitude": 37.15,
      "longitude": -8.52,
      "municipality": "Portim\u00e3o",
      "municipality_code": "0811",
      "risk": "Very high",
      "risk_level": 4
    },
    {
      "district": "Faro",
      "latitude": 37.15,
      "longitude": -7.89,
      "municipality": "S\u00e3o Br\u00e1s de Alportel",
      "municipality_code": "0812",
      "risk": "Very high",
      "risk_level": 4
    },
    {
      "district": "Faro",
      "latitude": 37.19,
      "longitude": -8.44,
      "municipality": "Silves",
      "municipality_code": "0813",
      "risk": "Very high",
      "risk_level": 4
    },
    {
      "district": "Faro",
      "latitude": 37.13,
      "longitude": -7.65,
      "municipality": "Tavira",
      "municipality_code": "0814",
      "risk": "Very high",
      "risk_level": 4
    }
  ],
  "summary": "Fire risk for 7 municipalities on 2026-11-02; the highest is Very high in 7 of them.",
  "updated_at": "2026-11-02T09:35:02Z"
}

Get forecast for every location

Get one day's weather forecast for every place IPMA forecasts for (today, tomorrow or the day after), optionally only in one region: the weather in words, temperatures, rain and wind.

Inputs

Daydaytext
Which day's forecast: today, tomorrow or the day after. Defaults to today.One of: today, tomorrow, day_after_tomorrow (The day after tomorrow). Default: today.
Regionregiontext
Only mainland Portugal, Madeira or the Azores. Leave blank for all three.One of: mainland (Mainland Portugal), madeira, azores.

Outputs

countnumber
How many rows are listed.
datetext
The day the forecast is for (YYYY-MM-DD).
locationslist
The forecast for each place, by name.
regiontext
The region asked for, or null for all three.
summarytext
One line with the day, how many places and the warmest.
updated_attext
When IPMA last updated this forecast (ISO 8601, UTC).
Example output
{
  "count": 4,
  "date": "2026-11-03",
  "locations": [
    {
      "latitude": 40.6413,
      "location_id": "1010500",
      "location_name": "Aveiro",
      "longitude": -8.6535,
      "max_temperature_c": 22.0,
      "min_temperature_c": 10.0,
      "rain_intensity": null,
      "rain_probability_percent": 0.0,
      "region": "Mainland",
      "weather": "Partly cloudy",
      "wind_direction": "E",
      "wind_direction_name": "East",
      "wind_strength": "Moderate"
    },
    {
      "latitude": 32.6485,
      "location_id": "2310300",
      "location_name": "Funchal",
      "longitude": -16.9084,
      "max_temperature_c": 23.0,
      "min_temperature_c": 19.0,
      "rain_intensity": "Moderate",
      "rain_probability_percent": 98.0,
      "region": "Madeira",
      "weather": "Showers or rain",
      "wind_direction": "SW",
      "wind_direction_name": "Southwest",
      "wind_strength": "Light"
    },
    {
      "latitude": 38.766,
      "location_id": "1110600",
      "location_name": "Lisboa",
      "longitude": -9.1286,
      "max_temperature_c": 22.0,
      "min_temperature_c": 11.0,
      "rain_intensity": null,
      "rain_probability_percent": 0.0,
      "region": "Mainland",
      "weather": "Partly cloudy",
      "wind_direction": "NE",
      "wind_direction_name": "Northeast",
      "wind_strength": "Light"
    },
    {
      "latitude": 37.7415,
      "location_id": "3420300",
      "location_name": "Ponta Delgada",
      "longitude": -25.6677,
      "max_temperature_c": 21.0,
      "min_temperature_c": 16.0,
      "rain_intensity": null,
      "rain_probability_percent": 6.0,
      "region": "Azores",
      "weather": "Sunny intervals",
      "wind_direction": "NE",
      "wind_direction_name": "Northeast",
      "wind_strength": "Moderate"
    }
  ],
  "region": null,
  "summary": "Forecast for 4 locations on 2026-11-03; the warmest is Funchal at 23 \u00b0C.",
  "updated_at": "2026-11-02T17:31:03Z"
}

Get latest observations

Get the latest hourly reading of IPMA's weather stations: temperature, humidity, pressure, wind, rain and sunshine, for the stations you choose or every station in a region.

Inputs

Stationsstationslist
The weather stations to read, from the list or by name or id. Leave blank for every station.
Regionregiontext
Only mainland Portugal, Madeira or the Azores. Leave blank for all three.One of: mainland (Mainland Portugal), madeira, azores.

Outputs

countnumber
How many rows are listed.
observationslist
Each station's latest reading, by station name. A value a station doesn't measure is null.
observed_attext
The newest hour among the readings (ISO 8601, UTC).
stations_without_readingslist
Stations asked for that sent nothing in the last three hours.
summarytext
One line saying what was found.
Example output
{
  "count": 2,
  "observations": [
    {
      "humidity_percent": 52.0,
      "latitude": 38.7191,
      "longitude": -9.1497,
      "observed_at": "2026-11-02T17:00:00Z",
      "pressure_hpa": 1017.0,
      "rain_mm": 0.0,
      "region": "Mainland",
      "solar_radiation_kj_m2": 536.7,
      "station_id": "1200535",
      "station_name": "Lisboa (Geof\u00edsico)",
      "temperature_c": 21.5,
      "wind_direction": "W",
      "wind_direction_name": "West",
      "wind_speed_kmh": 8.3,
      "wind_speed_ms": 2.3
    },
    {
      "humidity_percent": 36.0,
      "latitude": 38.7618,
      "longitude": -9.1254,
      "observed_at": "2026-11-02T17:00:00Z",
      "pressure_hpa": null,
      "rain_mm": 0.0,
      "region": "Mainland",
      "solar_radiation_kj_m2": null,
      "station_id": "1210580",
      "station_name": "Lisboa, Rel\u00f3gio",
      "temperature_c": 23.4,
      "wind_direction": "NE",
      "wind_direction_name": "Northeast",
      "wind_speed_kmh": 4.0,
      "wind_speed_ms": 1.1
    }
  ],
  "observed_at": "2026-11-02T17:00:00Z",
  "stations_without_readings": [],
  "summary": "Latest readings of 2 stations, the newest at 2026-11-02T17:00:00Z."
}

Get recent earthquakes

Get the earthquakes IPMA recorded in the last 30 days in mainland Portugal, Madeira or the Azores, newest first: time, magnitude, depth, place and whether and where people felt it.

Inputs

Areaareatext
Where to look. Mainland Portugal includes the sea and border areas around it. Defaults to mainland Portugal.One of: mainland (Mainland Portugal), madeira, azores. Default: mainland.
Lowest magnitudeminimum_magnitudenumber
Only earthquakes of at least this magnitude, e.g. 3. Leave blank for all.From 0 to 10.
Felt onlyfelt_onlytrue/false
Only earthquakes people reported feeling.Default: false.
Most earthquakeslimitnumber
The most earthquakes to list, newest first, from 1 to 500. Defaults to 50.From 1 to 500. Default: 50.

Outputs

areatext
The area searched: Mainland Portugal, Madeira or Azores.
countnumber
How many are listed here, at most the number asked for.
earthquakeslist
The earthquakes, newest first.
summarytext
One line with how many there were and the strongest.
totalnumber
How many earthquakes match in the last 30 days.
updated_attext
When IPMA last updated its list (ISO 8601, UTC).
Example output
{
  "area": "Azores",
  "count": 2,
  "earthquakes": [
    {
      "area": "Azores",
      "depth_km": 2.0,
      "event_id": null,
      "felt": false,
      "felt_at": null,
      "intensity": null,
      "latitude": 37.747,
      "longitude": -26.351,
      "magnitude": 2.2,
      "magnitude_type": "Local magnitude (ML)",
      "place": "S Fossa de Hirondelle",
      "shakemap_url": null,
      "time": "2026-11-01T22:40:32Z"
    },
    {
      "area": "Azores",
      "depth_km": 8.0,
      "event_id": "20261101223738A",
      "felt": false,
      "felt_at": null,
      "intensity": null,
      "latitude": 38.735,
      "longitude": -27.282,
      "magnitude": 2.3,
      "magnitude_type": "Local magnitude (ML)",
      "place": "Serra Sta. B\u00e1rbara",
      "shakemap_url": null,
      "time": "2026-11-01T22:37:38Z"
    }
  ],
  "summary": "3 earthquakes in the Azores in the last 30 days; the strongest, magnitude 5.3, near Fossa de Hirondelle at 2026-10-20T18:07:19Z.",
  "total": 3,
  "updated_at": "2026-11-02T17:36:02Z"
}

Get sea forecast

Get the sea forecast for the coast of mainland Portugal, Madeira and the Azores for today, tomorrow or the day after: wave and swell height, swell period, wave direction and sea temperature.

Inputs

Daydaytext
Which day's forecast: today, tomorrow or the day after. Defaults to today.One of: today, tomorrow, day_after_tomorrow (The day after tomorrow). Default: today.
Coastal locationscoastal_locationslist
Only these stretches of coast. Leave blank for all of them.

Outputs

countnumber
How many rows are listed.
datetext
The day the forecast is for (YYYY-MM-DD).
locationslist
The sea forecast for each coastal place, by name.
summarytext
One line with the day and where the waves are highest.
updated_attext
When IPMA last updated this forecast (ISO 8601, UTC).
Example output
{
  "count": 3,
  "date": "2026-11-02",
  "locations": [
    {
      "latitude": 32.75,
      "location_id": "2310326",
      "location_name": "Funchal, costa",
      "longitude": -16.91,
      "region": "Madeira",
      "sea_temperature_max_c": 23.2,
      "sea_temperature_min_c": 22.5,
      "swell_height_max_m": 1.0,
      "swell_height_min_m": 0.5,
      "swell_period_max_s": 5.8,
      "swell_period_min_s": 5.1,
      "wave_direction": "SW",
      "wave_direction_name": "Southwest",
      "wave_height_max_m": 1.0,
      "wave_height_min_m": 0.5
    },
    {
      "latitude": 38.65,
      "location_id": "1111026",
      "location_name": "Lisboa, costa",
      "longitude": -9.31,
      "region": "Mainland",
      "sea_temperature_max_c": 15.9,
      "sea_temperature_min_c": 15.6,
      "swell_height_max_m": 1.3,
      "swell_height_min_m": 0.9,
      "swell_period_max_s": 9.9,
      "swell_period_min_s": 10.0,
      "wave_direction": "NW",
      "wave_direction_name": "Northwest",
      "wave_height_max_m": 1.5,
      "wave_height_min_m": 1.0
    },
    {
      "latitude": 41.175,
      "location_id": "1130826",
      "location_name": "Porto, costa",
      "longitude": -8.76,
      "region": "Mainland",
      "sea_temperature_max_c": 15.5,
      "sea_temperature_min_c": 15.3,
      "swell_height_max_m": 1.5,
      "swell_height_min_m": 0.8,
      "swell_period_max_s": 9.8,
      "swell_period_min_s": 5.1,
      "wave_direction": "NW",
      "wave_direction_name": "Northwest",
      "wave_height_max_m": 1.5,
      "wave_height_min_m": 1.0
    }
  ],
  "summary": "Sea forecast for 3 coastal locations on 2026-11-02; the highest waves, up to 1.5 m, at Lisboa, costa.",
  "updated_at": "2026-11-02T17:31:02Z"
}

Get station's last 24 hours

Get one weather station's hourly readings for up to the last 24 hours, newest first: temperature, humidity, pressure, wind, rain and sunshine.

Inputs

StationstationtextRequired
The weather station, from the list or by name (e.g. Lisboa (Geofísico)) or id (e.g. 1200535).
Hourshoursnumber
How many of the last hours to list, from 1 to 24. Defaults to 24.From 1 to 24. Default: 24.

Outputs

countnumber
How many rows are listed.
latitudenumber
Latitude in decimal degrees.
longitudenumber
Longitude in decimal degrees (negative is west).
observationslist
The station's hourly readings, newest first. A value it doesn't measure is null.
regiontext
Mainland, Madeira or Azores.
station_idtext
IPMA's id for the weather station, e.g. '1200535'.
station_nametext
The station's name.
summarytext
One line with the station and its latest reading.
Example output
{
  "count": 3,
  "latitude": 38.71907778,
  "longitude": -9.14972222,
  "observations": [
    {
      "humidity_percent": 52.0,
      "observed_at": "2026-11-02T17:00:00Z",
      "pressure_hpa": 1017.0,
      "rain_mm": 0.0,
      "solar_radiation_kj_m2": 536.7,
      "temperature_c": 21.5,
      "wind_direction": "W",
      "wind_direction_name": "West",
      "wind_speed_kmh": 8.3,
      "wind_speed_ms": 2.3
    },
    {
      "humidity_percent": 43.0,
      "observed_at": "2026-11-02T16:00:00Z",
      "pressure_hpa": 1017.2,
      "rain_mm": 0.0,
      "solar_radiation_kj_m2": 1122.9,
      "temperature_c": 22.4,
      "wind_direction": "S",
      "wind_direction_name": "South",
      "wind_speed_kmh": 6.5,
      "wind_speed_ms": 1.8
    },
    {
      "humidity_percent": 37.0,
      "observed_at": "2026-11-02T15:00:00Z",
      "pressure_hpa": 1017.5,
      "rain_mm": 0.0,
      "solar_radiation_kj_m2": 1629.9,
      "temperature_c": 24.0,
      "wind_direction": "SW",
      "wind_direction_name": "Southwest",
      "wind_speed_kmh": 8.6,
      "wind_speed_ms": 2.4
    }
  ],
  "region": "Mainland",
  "station_id": "1200535",
  "station_name": "Lisboa (Geof\u00edsico)",
  "summary": "3 hourly readings from Lisboa (Geof\u00edsico); the latest, at 2026-11-02T17:00:00Z: 21.5 \u00b0C, 52% humidity, wind 8.3 km/h from W, 0 mm rain."
}

Get UV index forecast

Get the forecast UV index for the next five days, for every place IPMA covers or one place, with what it means (low to extreme).

Inputs

Locationlocationtext
Only this place, from the list or by name or id. Leave blank for every place.
Dayforecast_datedate
Only this day, within the next five. Leave blank for all five.

Outputs

countnumber
How many rows are listed.
forecastslist
The day's highest UV index for each place and day, by day and name.
summarytext
One line with the highest UV index and where.
Example output
{
  "count": 5,
  "forecasts": [
    {
      "date": "2026-11-02",
      "location_id": "1110600",
      "location_name": "Lisboa",
      "region": "Mainland",
      "risk": "Moderate",
      "uv_index": 3.6
    },
    {
      "date": "2026-11-03",
      "location_id": "1110600",
      "location_name": "Lisboa",
      "region": "Mainland",
      "risk": "Moderate",
      "uv_index": 3.4
    },
    {
      "date": "2026-11-04",
      "location_id": "1110600",
      "location_name": "Lisboa",
      "region": "Mainland",
      "risk": "Moderate",
      "uv_index": 3.3
    },
    {
      "date": "2026-11-05",
      "location_id": "1110600",
      "location_name": "Lisboa",
      "region": "Mainland",
      "risk": "Moderate",
      "uv_index": 3.3
    },
    {
      "date": "2026-11-06",
      "location_id": "1110600",
      "location_name": "Lisboa",
      "region": "Mainland",
      "risk": "Low",
      "uv_index": 2.0
    }
  ],
  "summary": "5 UV forecasts; the highest is 3.6 (Moderate) at Lisboa on 2026-11-02."
}

Get weather warnings

Get IPMA's weather warnings for the next three days: for each district or island area, what the warning is for (wind, rain, heat and so on), its level (yellow, orange or red), when it starts and ends, and IPMA's description in Portuguese.

Inputs

Areasareaslist
Only warnings for these districts or island areas. Leave blank for every area.One or more of: AVR (Aveiro), BJA (Beja), BRG (Braga), BGC (Bragança), CBO (Castelo Branco), CBR (Coimbra), EVR (Évora), FAR (Faro), GDA (Guarda), LRA (Leiria), and 15 more.
Lowest levelminimum_leveltext
The least serious warnings to list. Defaults to yellow, orange and red; green lists every area and type, including those with no warning.One of: yellow (Yellow, orange and red), orange (Orange and red), red (Red only), green (Every area and type, green (no warning) too). Default: yellow.
Warning typeswarning_typeslist
Only warnings for these kinds of weather. Leave blank for all.One or more of: thunderstorm, rough_seas (Rough seas), rain, wind, snow, low_temperature (Low temperature), high_temperature (High temperature), fog.

Outputs

countnumber
How many rows are listed.
minimum_leveltext
The lowest level listed: green, yellow, orange or red.
summarytext
One line with how many warnings there are of each level.
warningslist
The warnings for the next three days, the most serious first.
Example output
{
  "count": 2,
  "minimum_level": "green",
  "summary": "No yellow, orange or red warnings in the next three days; 2 listed as green (no warning).",
  "warnings": [
    {
      "area_code": "LSB",
      "area_name": "Lisboa",
      "description": null,
      "ends_at": "2026-11-05T11:00:00Z",
      "level": "green",
      "region": "Mainland",
      "starts_at": "2026-11-02T11:34:00Z",
      "type": "Rain",
      "warning_id": "LSB-rain-green-2026-11-02T11:34:00Z"
    },
    {
      "area_code": "LSB",
      "area_name": "Lisboa",
      "description": null,
      "ends_at": "2026-11-05T11:00:00Z",
      "level": "green",
      "region": "Mainland",
      "starts_at": "2026-11-02T11:34:00Z",
      "type": "Wind",
      "warning_id": "LSB-wind-green-2026-11-02T11:34:00Z"
    }
  ]
}

List forecast locations

List the places IPMA forecasts for: the district capitals, the island towns of Madeira and the Azores and a few others, each with its id, district, municipality and weather warning area.

Inputs

Regionregiontext
Only mainland Portugal, Madeira or the Azores. Leave blank for all three.One of: mainland (Mainland Portugal), madeira, azores.

Outputs

countnumber
How many rows are listed.
locationslist
The forecast locations.
regiontext
The region asked for, or null for all three.
summarytext
One line saying what was found.
Example output
{
  "count": 2,
  "locations": [
    {
      "district": "Aveiro",
      "latitude": 40.6413,
      "location_id": "1010500",
      "longitude": -8.6535,
      "municipality_code": "0105",
      "name": "Aveiro",
      "region": "Mainland",
      "warning_area": "AVR",
      "warning_area_name": "Aveiro"
    },
    {
      "district": "Lisboa",
      "latitude": 38.766,
      "location_id": "1110600",
      "longitude": -9.1286,
      "municipality_code": "1106",
      "name": "Lisboa",
      "region": "Mainland",
      "warning_area": "LSB",
      "warning_area_name": "Lisboa"
    }
  ],
  "region": "Mainland",
  "summary": "IPMA forecasts for 2 locations in mainland Portugal."
}

List weather stations

Find IPMA's weather stations by name or region, with each one's id and position, for the observation actions.

Inputs

Name containsnametext
Only stations whose name contains this text, e.g. Lisboa or Aeroporto. Leave blank for every station.
Regionregiontext
Only mainland Portugal, Madeira or the Azores. Leave blank for all three.One of: mainland (Mainland Portugal), madeira, azores.

Outputs

countnumber
How many rows are listed.
stationslist
The weather stations, by name.
summarytext
One line saying what was found.
Example output
{
  "count": 2,
  "stations": [
    {
      "latitude": 38.71907778,
      "longitude": -9.14972222,
      "name": "Lisboa (Geof\u00edsico)",
      "region": "Mainland",
      "station_id": "1200535"
    },
    {
      "latitude": 38.7618,
      "longitude": -9.1254,
      "name": "Lisboa, Rel\u00f3gio",
      "region": "Mainland",
      "station_id": "1210580"
    }
  ],
  "summary": "Found 2 weather stations named like 'Lisboa'."
}

On this page