Skip to main content
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.