Get the historical weather for a place
Measured weather at a place in the Netherlands since 2000, per hour, day or month, from the Open-Meteo archive (ERA5 reanalysis). Per day and month: mean, lowest and highest temperature, solar radiation, precipitation, and heating degree days on an 18 °C base, also weighted the Dutch way (1.1 from November to February, 1.0 in March and October, 0.8 from April to September). Per hour: temperature, radiation, cloud cover and precipitation. Sunshine hours are left out because the reanalysis overcounts them. The archive lags a few days, so first_day and last_day say which days came back. With hour the window is at most 31 days, with day and month at most 1,100 days. Any personal token may read it.
API token from the Joulo dashboard, or an OAuth2 access token.
In: header
Query Parameters
A postcode (1234 or 1234AB) or a place name in the Netherlands.
First day (YYYY-MM-DD), from 2000-01-01. Default: 29 days before to.
dateLast day (YYYY-MM-DD), inclusive, at most yesterday. Default: yesterday.
datePeriod per row.
"day""hour" | "day" | "month"Response Body
curl -X GET "https://api.joulo.nl/functions/v1/api/weather-history?place=6971&from=2019-08-24&to=2019-08-24&bucket=hour"{
"source": "Open-Meteo historical weather (ERA5 reanalysis)",
"timezone": "Europe/Amsterdam",
"location": {
"label": "Brummen, Brummen, Gelderland",
"lat": 52.09,
"lon": 6.16
},
"bucket": "month",
"from": "2025-01-01",
"to": "2025-12-31",
"heating_degree_days_base_c": 18,
"days_with_data": 365,
"first_day": "2025-01-01",
"last_day": "2025-12-31",
"summary": {
"mean_temperature_c": 11.1,
"radiation_kwh_per_m2": 1220.12,
"precipitation_mm": 672.6,
"heating_degree_days": 2655,
"weighted_heating_degree_days": 2712.3
},
"columns": [
"month",
"mean_temperature_c",
"min_temperature_c",
"max_temperature_c",
"radiation_kwh_per_m2",
"precipitation_mm",
"heating_degree_days",
"weighted_heating_degree_days"
],
"rows": [
[
"2025-01",
3,
-3.5,
11.6,
24.11,
81.4,
464.2,
510.6
]
]
}{
"error": "invalid_place",
"detail": "place must be a postcode or a place name."
}{
"error": "Missing or invalid API token"
}{
"error": "unknown_place",
"detail": "No place in the Netherlands matches this postcode or name."
}{
"error": "weather_unavailable",
"detail": "The weather service did not answer. Try again later."
}