Skip to main content
When scheduling energy consumption or exports — and when reporting energy costs — it is essential to account for local generation. Flatpeak provides the following options:
  • Forecast solar generation using PV system rating and actual data
  • Submit your own solar forecast if you prefer to use external forecasting models
Forecast data will be automatically used to optimise energy scheduling
Submit actual generation data after the event to ensure accurate cost calculations
To implement, choose one of the two options:
  • Use Flatpeak forecasts
  • Use your own forecasts
This feature is in limited Beta. Contact support for early access.
Call the create-device endpoint and set:
FieldDescription
location_idFlatpeak Location ID where the PV system is installed.
reference_idYour internal device ID for cross-reference.
pv_system.rated_power_kwPV system’s rated output power in kW.
pv_system.install_dateOptional. Installation date (YYYY-MM-DDTHH:MM:SSZ) used to estimate performance degradation due to system ageing.
pv_system.azimuthOptional. Default is the optimal azimuth calculated from latitude. Azimuth is the angle (°) from true north that the PV system faces. An azimuth of 0° means facing north. Positive values are anticlockwise (e.g. -90° = east, 135° = southwest). Defaults to 0° (north-facing, southern hemisphere) or 180° (south-facing, northern hemisphere).
pv_system.tiltOptional. Default is 23°. Tilt angle of the PV system in degrees (0–90). A tilt of 0° means facing upwards, and 90° means vertical.
pv_system.terrain_shadingOptional. Default is false. If true, irradiance is adjusted for surrounding terrain using a 90 m-resolution elevation model. Direct irradiance is set to zero when the sun is blocked; diffuse irradiance is reduced when the sky view is limited.
pv_system.forecasts.enabledEnables solar forecasting for this device. Defaults to false.
Store the returned device_id permanently in your system
curl --request POST \
  --url https://api.flatpeak.com/devices \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "reference_id": "DEV1234567890",
  "location_id": "loc_641b90b758fb8e6293716e40",
  "pv_system": {
    "rated_power_kw": 15.3,
    "install_date": "2025-06-12T00:00:00Z",
    "azimuth": 0,
    "tilt": 23,
    "terrain_shading": false,
    "forecasts_enabled": true
   }
  }
}'
Flatpeak now automatically generates solar forecasts for all relevant requests. The forecasts_last_updated timestamp indicates when the forecasts were last generated.To disable this feature, set pv_system.forecasts_enabled = false.