List Meter Values
Data
List Meter Values
GET
List Meter Values
Returns a paginated list of historical OCPP meter values for the specified charger.
If you only need the most recent meter value, use Get Latest Meter Value instead.
string
required
The UUID of the charger.
string
required
Start date for the query. Format:
Y-m-d H:i:s (e.g., 2025-01-01 00:00:00).string
required
End date for the query. Format:
Y-m-d H:i:s (e.g., 2025-12-31 23:59:59).string
Filter by measurement context. One of
Interruption.Begin, Interruption.End, Other, Sample.Clock, Sample.Periodic, Transaction.Begin, Transaction.End, or Trigger.string
Filter by measurand type. One of
Current.Export, Current.Import, Current.Offered, Energy.Active.Export.Register, Energy.Active.Import.Register, Energy.Reactive.Export.Register, Energy.Reactive.Import.Register, Energy.Active.Export.Interval, Energy.Active.Import.Interval, Energy.Reactive.Export.Interval, Energy.Reactive.Import.Interval, Frequency, Power.Active.Export, Power.Active.Import, Power.Factor, Power.Offered, Power.Reactive.Export, Power.Reactive.Import, RPM, SoC, Temperature, or Voltage.string
Filter by phase. One of
L1, L2, L3, N, L1-N, L2-N, L3-N, L1-L2, L2-L3, or L3-L1.string
Filter by measurement location. One of
Body, Inlet, Cable, Outlet, or EV.string
Filter by unit. One of
Wh, kWh, varh, kvarh, W, kW, VA, kVA, var, kvar, A, V, Celsius, Fahrenheit, K, or Percent.integer
Maximum number of results to return. Maximum 10,000.
string
Sort order. Either
asc or desc.Response
integer
The meter value record ID.
integer
The ID of the charger.
integer
Deprecated. Use
connector_id instead.integer
The connector ID this meter value belongs to.
integer
Deprecated. Use
transaction_id instead.integer
The transaction ID this meter value belongs to. May be
null.string
ISO 8601 timestamp of the measurement.
string
The measured value as a string.
string
The context of the reading.
string
Deprecated. Always returns
Raw.string
The type of measurement.
string
The phase this value applies to. May be
null.string
The measurement location.
string
The unit of measurement.