Api referenceEnergy
Get a solar yield forecast for a place
What solar panels yield at a place in the Netherlands, per hour and per day, for today and up to 6 more days. The yield is the global tilted irradiance from the Open-Meteo forecast times the system size and a performance ratio of 0.85. Each hour row covers the hour that starts at hour_start_local. per_day.kwh_per_kwp scales to any system size. The place is a postcode or a name, never your stored address. Any personal token may read it.
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.
days?integer
Days including today.
Default
2Range
1 <= value <= 7kwp?number
System size in kWp.
Default
1Range
0.1 <= value <= 100tilt?number
Panel tilt in degrees: 0 flat, 90 vertical.
Default
35Range
0 <= value <= 90azimuth?number
Direction in degrees: 0 south, -90 east, 90 west.
Default
0Range
-180 <= value <= 180Response Body
curl -X GET "https://api.joulo.nl/functions/v1/api/solar-forecast?place=6971&days=2&kwp=1&tilt=35&azimuth=0"{
"source": "Open-Meteo forecast (global tilted irradiance)",
"timezone": "Europe/Amsterdam",
"location": {
"label": "postcode 6971",
"lat": 52.09,
"lon": 6.15
},
"system": {
"kwp": 5,
"tilt_degrees": 35,
"azimuth_degrees": 0,
"azimuth_convention": "0 south, -90 east, 90 west",
"performance_ratio": 0.85
},
"per_day": [
{
"date": "2026-10-28",
"kwh": 16.18,
"kwh_per_kwp": 3.24,
"peak_hour_start": "12:00",
"peak_kwh": 2.804,
"hours_with_data": 24
}
],
"columns": [
"hour_start_local",
"irradiance_w_per_m2",
"kwh"
],
"rows": [
[
"2026-10-28 12:00",
659.7,
2.804
]
]
}{
"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."
}