This feature is an invite-only preview. Contact support@flatpeak.com for availability.

​
Introduction

When planning energy consumption or exports, it is critical to account for energy generated locally, for example, by a PV array or a wind turbine. FlatPeak enables you to inject local energy generation data via Metering API and use this information to calculate the energy cost savings your solution delivers.

To account for local generation set the tariff_rate parameter to LOCAL when submitting metering values that represent forecasted or actual local generation.

​
Submitting forecast generation

When you want to submit forecast meter records, for example, for purposes of creating Copilot Schedules, set the confidence parameter to any value below ‘1’:

Forecasted local generation
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": "IMPORT",
    "tariff_rate": "LOCAL",
    "units": "W",
    "value": 968,
    "confidence": 0.9,
    "start_time": "2025-08-01T10:30:00Z",
    "end_time": "2025-08-01T11:00:00Z"
  }
]'

​
Submitting actual generation

When submitting the actual meter records, set the confidence parameter to ‘1’. When you submit records, they will overwrite records you submitted previously for the same period:

Actual local generation
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": "IMPORT",
    "tariff_rate": "LOCAL",
    "units": "W",
    "value": 1014,
    "confidence": 1,
    "start_time": "2023-02-01T10:30:00Z",
    "end_time": "2023-02-01T11:00:00Z"
  }
]'

Was this page helpful?

Getting market ratesScheduling energy use