Accounting local generation

When creating consumption schedules or calculating energy costs for a device, it is critical to account for energy generated locally, for example, by a PV array or wind turbine.

FlatPeak enables you to inject local energy generation data via metering endpoint. Submitted data will be used when calculating energy costs and creating schedules.

Set the direction parameter to LOCAL and submit metering values that represent forecasted or actual local generation, excluding any energy that will be or was exported into the grid.

​

Submitting local generation data

Note, you can only submit metering records with the LOCAL direction relative to location_id and not the device_id. Every time you submit a record it will overwrite any records that you might have submitted previously for the same period.

1. When submitting forecasted data, set confidence to any value below ‘1’:

curl --request PUT \
  --url https://api.flatpeak.com/meters/interval \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '[
  {
    "location_id": "loc_641b90b758fb8e6293716e40",
    "direction": "LOCAL",
    "units": "W",
    "value": 968,
    "confidence": 0.9,
    "start_time": "2025-08-01T10:30:00Z",
    "end_time": "2025-08-01T11:00:00Z"
  }
]'

2. When submitting actual data, set confidence to ‘1’:

curl --request PUT \
  --url https://api.flatpeak.com/meters/interval \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '[
  {
    "location_id": "loc_641b90b758fb8e6293716e40",
    "direction": "LOCAL",
    "units": "W",
    "value": 1014,
    "confidence": 1,
    "start_time": "2023-02-01T10:30:00Z",
    "end_time": "2023-02-01T11:00:00Z"
  }
]'

The general availability of local energy sources accounting is expected in Q4 2024. If you would like to join the preview program, please get in touch with support.