JouloDocs
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.

GET
/solar-forecast
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.

Default2
Range1 <= value <= 7
kwp?number

System size in kWp.

Default1
Range0.1 <= value <= 100
tilt?number

Panel tilt in degrees: 0 flat, 90 vertical.

Default35
Range0 <= value <= 90
azimuth?number

Direction in degrees: 0 south, -90 east, 90 west.

Default0
Range-180 <= value <= 180

Response 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."
}