Sofar logo
Sofar logo
Api

Api Measurements

The following table lists the available fields for which data can be retrieved via the Eniris Metadata & Telemetry Query API.
Data for a specific field is only available for the specified measurements and retention policies.

Power related fields

Field nameDescriptionUnit Of MeasurementMeasurementRetention Policy
actualPowerTot_WTotal active power at the current time.Watt (W)
  • submeteringMetrics
  • batteryMetrics
  • hybridInverterMetrics
⚠️ For the previous measurements:
Positive values indicate charging, consumption or import.
Negative values indicate discharging or export.
  • solarInverterMetrics
  • solarInstallationMetrics
  • solarOptimizerMetrics
  • solarStringMetrics
⚠️ For these measurements the values indicate production.
  • gridMetrics
  • evChargerMetrics
  • heatPumpMetrics
  • boilerMetrics
  • switchedLoadMetrics
  • installationMetrics
⚠️ For these measurements values indicate consumption.
  • rp_one_s
  • rp_one_m
  • rp_ten_m
childrenStoragePower_WTotal real-time charging or discharging power of all connected batteries at a particular site.Watt (W)submeteringMetrics
  • rp_one_s
  • rp_one_m
  • rp_ten_m
childrenProducedPower_WTotal real-time power production of all connected power producing devices at a particular site.Watt (W)submeteringMetrics
  • rp_one_s
  • rp_one_m
  • rp_ten_m
childrenEVPower_WTotal real-time power consumption of all connected EV chargers at a particular site.Watt (W)submeteringMetrics
  • rp_one_s
  • rp_one_m
  • rp_ten_m
childrenConsumedPower_WTotal real-time power demand of all connected energy consuming devices at a particular site.Watt (W)submeteringMetricsrp_one_m
childrenOtherPower_WTotal real-time power consumption of devices that aren't EV chargers or heatpumps at a particular site.Watt (W)submeteringMetrics
  • rp_one_s
  • rp_one_m
  • rp_ten_m

Energy related fields

Field nameDescriptionUnit Of MeasurementMeasurementRetention Policy
importedAbsEnergyTot_WhTotal imported energyWatt-hour (Wh)
  • hybridInverterMetrics
  • submeteringMetrics
  • rp_one_m
  • rp_ten_m
exportedAbsEnergyTot_WhTotal exported energyWatt-hour (Wh)
  • hybridInverterMetrics
  • submeteringMetrics
  • rp_one_m
  • rp_ten_m
producedAbsEnergyTot_WhTotal produced energyWatt-hour (Wh)
  • solarInverterMetrics
  • solarOptimizerMetrics
  • hybridInverterMetrics
  • installationMetrics
  • solarStringMetrics
  • rp_one_m
  • rp_ten_m
consumedAbsEnergyTot_WhTotal consumed energyWatt-hour (Wh)
  • solarInverterMetrics
  • evChargerMetrics
  • heatPumpMetrics
  • switchedLoadMetrics
  • hybridInverterMetrics
  • rp_one_m
  • rp_ten_m
chargedAbsEnergyTot_WhTotal charged energyWatt-hour (Wh)
  • evChargerMetrics
  • hybridInverterMetrics
  • batteryMetrics
  • rp_one_m
  • rp_ten_m
dischargedAbsEnergyTot_WhTotal discharged energyWatt-hour (Wh)
  • evChargerMetrics
  • hybridInverterMetrics
  • batteryMetrics
  • rp_one_m
  • rp_ten_m
importedEnergyDeltaTot_WhImported energy delta between two points in timeWatt-hour (Wh)
  • hybridInverterMetrics
  • submeteringMetrics
  • rp_one_m
  • rp_ten_m
exportedEnergyDeltaTot_WhExported energy delta between two points in timeWatt-hour (Wh)
  • hybridInverterMetrics
  • submeteringMetrics
  • rp_one_m
  • rp_ten_m
childrenStorageChargedEnergyDeltaTot_WhTotal charged energy delta between two points in time of all connected batteries at a particular site.Watt-hour (Wh)submeteringMetrics
  • rp_one_m
  • rp_ten_m
childrenStorageDischargedEnergyDeltaTot_WhTotal discharged energy delta between two points in time of all connected batteries at a particular site.Watt-hour (Wh)submeteringMetrics
  • rp_one_m
  • rp_ten_m
producedEnergyDeltaTot_WhTotal produced energy delta between two points in timeWatt-hour (Wh)
  • solarInverterMetrics
  • solarInstallationMetrics
  • solarOptimizerMetrics
  • hybridInverterMetrics
  • installationMetrics
  • solarStringMetrics
  • submeteringMetrics (only rp_one_m)
  • rp_one_m
  • rp_ten_m
chargedEnergyDeltaTot_WhCharged energy delta between two points in timeWatt-hour (Wh)
  • evChargerMetrics
  • hybridInverterMetrics (only rp_one_m)
  • batteryMetrics
  • rp_one_m
  • rp_ten_m
dischargedEnergyDeltaTot_WhDischarged energy delta between two points in timeWatt-hour (Wh)
  • evChargerMetrics
  • hybridInverterMetrics (only rp_one_m)
  • batteryMetrics
  • rp_one_m
  • rp_ten_m

Planning related fields

Field nameDescriptionUnit Of MeasurementMeasurementRetention Policy
powerSetpoint_WCommand power setpointWatt (W)planning
  • rp_one_s
  • rp_one_m
  • rp_ten_m
policyCommand Policy-planning
  • rp_one_s
  • rp_one_m
  • rp_ten_m
constraint_ph0_labelConstraint Label-planning
  • rp_one_s
  • rp_one_m
  • rp_ten_m
reactivePowerSetpoint_VArReactive Power SetpointVolt-Ampere reactive (VAr)planning
  • rp_one_s
  • rp_one_m
  • rp_ten_m

Other fields

Field nameDescriptionUnit Of MeasurementMeasurementRetention Policy
currentL1_APhase 1 (Line 1) currentAmpere (A)
  • evChargerMetrics
  • heatPumpMetrics
  • boilerMetrics
  • switchedLoadMetrics
  • solarInverterMetrics
  • solarOptimizerMetrics
  • hybridInverterMetrics
  • submeteringMetrics
  • batteryMetrics
  • rp_one_s
  • rp_one_m
  • rp_ten_m
currentL2_APhase 2 (Line 2) currentAmpere (A)
  • evChargerMetrics
  • heatPumpMetrics
  • boilerMetrics
  • solarInverterMetrics
  • solarOptimizerMetrics
  • hybridInverterMetrics
  • installationMetrics (only rp_one_m)
  • submeteringMetrics
  • batteryMetrics
  • rp_one_s
  • rp_one_m
  • rp_ten_m
currentL3_APhase 3 (Line 3) currentAmpere (A)
  • evChargerMetrics
  • heatPumpMetrics
  • boilerMetrics
  • solarInverterMetrics
  • solarOptimizerMetrics
  • hybridInverterMetrics
  • installationMetrics (only rp_one_m)
  • submeteringMetrics
  • batteryMetrics
  • rp_one_s
  • rp_one_m
  • rp_ten_m
currentN_ANeutral currentAmpere (A)
  • evChargerMetrics
  • hybridInverterMetrics
  • submeteringMetrics
rp_one_m
voltageL1N_VPhase 1 to Neutral voltage (Phase Voltage)Volt (V)
  • evChargerMetrics
  • heatPumpMetrics (only rp_one_m)
  • boilerMetrics (only rp_one_m or rp_ten_m)
  • switchedLoadMetrics (only rp_one_m or rp_ten_m)
  • solarInverterMetrics
  • solarOptimizerMetrics (only rp_one_m or rp_ten_m)
  • hybridInverterMetrics (only rp_one_m or rp_ten_m)
  • submeteringMetrics (only rp_one_m or rp_ten_m)
  • batteryMetrics (only rp_one_m or rp_ten_m)
  • rp_one_s
  • rp_one_m
  • rp_ten_m
voltageL2N_VPhase 2 to Neutral voltage (Phase Voltage)Volt (V)
  • evChargerMetrics
  • boilerMetrics (only rp_one_m or rp_ten_m)
  • solarInverterMetrics (only rp_one_m or rp_ten_m)
  • solarOptimizerMetrics (only rp_one_m or rp_ten_m)
  • hybridInverterMetrics (only rp_one_m or rp_ten_m)
  • submeteringMetrics (only rp_one_m or rp_ten_m)
  • batteryMetrics (only rp_one_m or rp_ten_m)
  • rp_one_s
  • rp_one_m
  • rp_ten_m
voltageL3N_VPhase 3 to Neutral voltage (Phase Voltage)Volt (V)
  • evChargerMetrics
  • boilerMetrics (only rp_one_m or rp_ten_m)
  • solarInverterMetrics (only rp_one_m or rp_ten_m)
  • solarOptimizerMetrics (only rp_one_m or rp_ten_m)
  • hybridInverterMetrics (only rp_one_m or rp_ten_m)
  • submeteringMetrics (only rp_one_m or rp_ten_m)
  • batteryMetrics (only rp_one_m or rp_ten_m)
  • rp_one_s
  • rp_one_m
  • rp_ten_m
voltageL1L2_VLine-to-Line voltage between Phase 1 and Phase 2Volt (V)
  • evChargerMetrics
  • solarInverterMetrics
  • solarOptimizerMetrics (only rp_one_m)
  • hybridInverterMetrics
  • submeteringMetrics
  • batteryMetrics
  • rp_one_m
  • rp_ten_m
voltageL2L3_VLine-to-Line voltage between Phase 2 and Phase 3Volt (V)
  • evChargerMetrics
  • solarInverterMetrics
  • solarOptimizerMetrics (only rp_one_m)
  • hybridInverterMetrics
  • submeteringMetrics
  • batteryMetrics
  • rp_one_m
  • rp_ten_m
voltageL3L1_VLine-to-Line voltage between Phase 3 and Phase 1Volt (V)
  • evChargerMetrics
  • solarInverterMetrics
  • solarOptimizerMetrics (only rp_one_m)
  • hybridInverterMetrics
  • submeteringMetrics
  • batteryMetrics
  • rp_one_m
  • rp_ten_m
frequency_HzSystem frequencyHertz (Hz)
  • evChargerMetrics
  • boilerMetrics
  • switchedLoadMetrics
  • solarInverterMetrics
  • hybridInverterMetrics
  • submeteringMetrics
  • rp_one_s
  • rp_one_m
  • rp_ten_m
powerFactorTotTotal power factor-
  • evChargerMetrics
  • solarInverterMetrics
  • hybridInverterMetrics
  • submeteringMetrics
  • rp_one_m
  • rp_ten_m
powerFactorL1Phase 1 power factor-
  • hybridInverterMetrics
  • submeteringMetrics
rp_one_m
powerFactorL2Phase 2 power factor-
  • hybridInverterMetrics
  • submeteringMetrics
rp_one_m
powerFactorL3Phase 3 power factor-
  • hybridInverterMetrics
  • submeteringMetrics
rp_one_m
voltageDC_VDC voltageVolt (V)
  • evChargerMetrics
  • solarInverterMetrics
  • solarOptimizerMetrics
  • hybridInverterMetrics
  • solarStringMetrics
  • batteryMetrics
  • rp_one_m
  • rp_ten_m
currentDC_ADC currentAmpere (A)
  • evChargerMetrics
  • solarInverterMetrics
  • solarOptimizerMetrics
  • hybridInverterMetrics
  • solarStringMetrics
  • batteryMetrics
  • rp_one_m
  • rp_ten_m
statusDevice status (e.g. On, Off, Error)-
  • evChargerMetrics
  • heatPumpMetrics
  • boilerMetrics
  • solarInverterMetrics (only rp_one_m)
  • hybridInverterMetrics
  • installationMetrics (only rp_one_m)
  • rp_one_s
  • rp_one_m
  • rp_ten_m
operationModeDevice operation mode-
  • evChargerMetrics (only rp_one_m and rp_ten_m)
  • heatPumpMetrics
  • boilerMetrics
  • switchedLoadMetrics
  • solarInverterMetrics
  • solarOptimizerMetrics
  • hybridInverterMetrics
  • batteryMetrics
  • rp_one_s
  • rp_one_m
  • rp_ten_m
stateOfCharge_fracState of Charge (SoC)fraction (number between 0 and 1)
  • evChargerMetrics
  • hybridInverterMetrics
  • batteryMetrics
  • rp_one_s
  • rp_one_m
  • rp_ten_m
stateOfHealth_fracState of Health (SoH)fraction (number between 0 and 1)batteryMetricsrp_one_m
childrenStorageStateOfCharge_fracAverage State of Charge (SoC) of all connected batteries at a particular site.fraction (number between 0 and 1)submeteringMetrics
  • rp_one_m
  • rp_ten_m
batteryCurrent_AReal-time current to/from the batteryAmpere (A)batteryMetrics
  • rp_one_m
  • rp_ten_m
batteryVoltage_VReal-time voltage of the batteryVolt (V)batteryMetrics
  • rp_one_m
  • rp_ten_m
evRequiringChargeIndicates whether an EV is connected and requires a chargeTrue or FalseevChargerMetrics
  • rp_one_s
  • rp_one_m
  • rp_ten_m
setpoint_WExternal signal power setpointWatt (W)externalSignalMetrics
  • rp_one_s
  • rp_one_m
  • rp_ten_m
strategyExternal signal strategy-externalSignalMetrics
  • rp_one_s
  • rp_one_m
  • rp_ten_m
signalActiveIs an external signal active or not0 or 1externalSignalMetrics
  • rp_one_s
  • rp_one_m
  • rp_ten_m
reacPowerSetpoint_VArReactive power setpointVolt-Ampere reactive (VAr)externalSignalMetrics
  • rp_one_s
  • rp_one_m
  • rp_ten_m
importLimit_WImport power limit command for a particular site.Watt (W)externalSignalMetrics
  • rp_one_s
  • rp_one_m
  • rp_ten_m
exportLimit_WExport power limit command for a particular site.Watt (W)externalSignalMetrics
  • rp_one_s
  • rp_one_m
  • rp_ten_m

Get a new access token GET

Get a new access token

On this page

Api MeasurementsPower related fieldsEnergy related fieldsPlanning related fieldsOther fields