Skip to main content
GET
/
v3
/
chargers
/
{charger}
/
metervalues
List Meter Values
curl --request GET \
  --url https://app.plugchoice.com/api/v3/chargers/{charger}/metervalues \
  --header 'Authorization: Bearer <token>'
{
  "id": 123,
  "charger_id": 123,
  "charger_connector_id": 123,
  "connector_id": 123,
  "charger_transaction_id": 123,
  "transaction_id": 123,
  "timestamp": "<string>",
  "value": "<string>",
  "context": "<string>",
  "format": "<string>",
  "measurand": "<string>",
  "phase": "<string>",
  "location": "<string>",
  "unit": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://developer.plugchoice.com/llms.txt

Use this file to discover all available pages before exploring further.

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.
​
charger
string
required
The UUID of the charger.
​
date_from
string
required
Start date for the query. Format: Y-m-d H:i:s (e.g., 2025-01-01 00:00:00).
​
date_to
string
required
End date for the query. Format: Y-m-d H:i:s (e.g., 2025-12-31 23:59:59).
​
context
string
Filter by measurement context. One of Interruption.Begin, Interruption.End, Other, Sample.Clock, Sample.Periodic, Transaction.Begin, Transaction.End, or Trigger.
​
measurand
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.
​
phase
string
Filter by phase. One of L1, L2, L3, N, L1-N, L2-N, L3-N, L1-L2, L2-L3, or L3-L1.
​
location
string
Filter by measurement location. One of Body, Inlet, Cable, Outlet, or EV.
​
unit
string
Filter by unit. One of Wh, kWh, varh, kvarh, W, kW, VA, kVA, var, kvar, A, V, Celsius, Fahrenheit, K, or Percent.
​
limit
integer
Maximum number of results to return. Maximum 10,000.
​
order_by
string
Sort order. Either asc or desc.

​
Response

​
id
integer
The meter value record ID.
​
charger_id
integer
The ID of the charger.
​
charger_connector_id
integer
Deprecated. Use connector_id instead.
​
connector_id
integer
The connector ID this meter value belongs to.
​
charger_transaction_id
integer
Deprecated. Use transaction_id instead.
​
transaction_id
integer
The transaction ID this meter value belongs to. May be null.
​
timestamp
string
ISO 8601 timestamp of the measurement.
​
value
string
The measured value as a string.
​
context
string
The context of the reading.
​
format
string
Deprecated. Always returns Raw.
​
measurand
string
The type of measurement.
​
phase
string
The phase this value applies to. May be null.
​
location
string
The measurement location.
​
unit
string
The unit of measurement.