JouloDocs
Api referenceEnergy

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.

GET
/weather-history
AuthorizationBearer <token>

API token from the Joulo dashboard, or an OAuth2 access token.

In: header

Query Parameters

placestring

A postcode (1234 or 1234AB) or a place name in the Netherlands.

from?string

First day (YYYY-MM-DD), from 2000-01-01. Default: 29 days before to.

Formatdate
to?string

Last day (YYYY-MM-DD), inclusive, at most yesterday. Default: yesterday.

Formatdate
bucket?string

Period per row.

Default"day"
Value in"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."
}