> ## 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.

# List Meter Values

Returns a paginated list of historical OCPP meter values for the specified charger.

<Info>
  If you only need the most recent meter value, use [Get Latest Meter Value](/api-reference/connectors/get-latest-meter-value) instead.
</Info>

<ParamField path="charger" type="string" required>
  The UUID of the charger.
</ParamField>

<ParamField query="date_from" type="string" required>
  Start date for the query. Format: `Y-m-d H:i:s` (e.g., `2025-01-01 00:00:00`).
</ParamField>

<ParamField query="date_to" type="string" required>
  End date for the query. Format: `Y-m-d H:i:s` (e.g., `2025-12-31 23:59:59`).
</ParamField>

<ParamField query="context" type="string">
  Filter by measurement context. One of `Interruption.Begin`, `Interruption.End`, `Other`, `Sample.Clock`, `Sample.Periodic`, `Transaction.Begin`, `Transaction.End`, or `Trigger`.
</ParamField>

<ParamField query="measurand" type="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`.
</ParamField>

<ParamField query="phase" type="string">
  Filter by phase. One of `L1`, `L2`, `L3`, `N`, `L1-N`, `L2-N`, `L3-N`, `L1-L2`, `L2-L3`, or `L3-L1`.
</ParamField>

<ParamField query="location" type="string">
  Filter by measurement location. One of `Body`, `Inlet`, `Cable`, `Outlet`, or `EV`.
</ParamField>

<ParamField query="unit" type="string">
  Filter by unit. One of `Wh`, `kWh`, `varh`, `kvarh`, `W`, `kW`, `VA`, `kVA`, `var`, `kvar`, `A`, `V`, `Celsius`, `Fahrenheit`, `K`, or `Percent`.
</ParamField>

<ParamField query="limit" type="integer">
  Maximum number of results to return. Maximum 10,000.
</ParamField>

<ParamField query="order_by" type="string">
  Sort order. Either `asc` or `desc`.
</ParamField>

## Response

<ResponseField name="id" type="integer">
  The meter value record ID.
</ResponseField>

<ResponseField name="charger_id" type="integer">
  The ID of the charger.
</ResponseField>

<ResponseField name="charger_connector_id" type="integer">
  Deprecated. Use `connector_id` instead.
</ResponseField>

<ResponseField name="connector_id" type="integer">
  The connector ID this meter value belongs to.
</ResponseField>

<ResponseField name="charger_transaction_id" type="integer">
  Deprecated. Use `transaction_id` instead.
</ResponseField>

<ResponseField name="transaction_id" type="integer">
  The transaction ID this meter value belongs to. May be `null`.
</ResponseField>

<ResponseField name="timestamp" type="string">
  ISO 8601 timestamp of the measurement.
</ResponseField>

<ResponseField name="value" type="string">
  The measured value as a string.
</ResponseField>

<ResponseField name="context" type="string">
  The context of the reading.
</ResponseField>

<ResponseField name="format" type="string">
  Deprecated. Always returns `Raw`.
</ResponseField>

<ResponseField name="measurand" type="string">
  The type of measurement.
</ResponseField>

<ResponseField name="phase" type="string">
  The phase this value applies to. May be `null`.
</ResponseField>

<ResponseField name="location" type="string">
  The measurement location.
</ResponseField>

<ResponseField name="unit" type="string">
  The unit of measurement.
</ResponseField>