Skip to main content
GET
/
api
/
v3
/
chargers
/
{charger_uuid}
/
metervalues
List historical meter values
curl --request GET \
  --url https://app.plugchoice.com/api/v3/chargers/{charger_uuid}/metervalues \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "date_from": "2026-01-10 01:14:32",
  "date_to": "2026-01-10 01:14:32",
  "context": "Sample.Clock",
  "measurand": "Energy.Reactive.Export.Register",
  "phase": "L1-N",
  "location": "Body",
  "unit": "VA",
  "limit": 1,
  "order_by": "asc"
}
'
{
  "data": [
    {
      "id": 1,
      "charger_id": 1,
      "charger_connector_id": null,
      "charger_transaction_id": null,
      "timestamp": "2025-12-11T00:54:05.000000Z",
      "value": "11278",
      "context": "Transaction.Begin",
      "format": "Raw",
      "measurand": "Power.Factor",
      "phase": "L2-N",
      "location": "Body",
      "unit": "kWh"
    },
    {
      "id": 2,
      "charger_id": 2,
      "charger_connector_id": null,
      "charger_transaction_id": null,
      "timestamp": "2026-01-03T05:43:17.000000Z",
      "value": "18301",
      "context": "Interruption.Begin",
      "format": "Raw",
      "measurand": "Power.Active.Import",
      "phase": "L2",
      "location": "Outlet",
      "unit": "VA"
    }
  ],
  "links": {
    "first": "/?page=1",
    "last": "/?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "url": null,
        "label": "&laquo; Previous",
        "page": null,
        "active": false
      },
      {
        "url": "/?page=1",
        "label": "1",
        "page": 1,
        "active": true
      },
      {
        "url": null,
        "label": "Next &raquo;",
        "page": null,
        "active": false
      }
    ],
    "path": "/",
    "per_page": 25,
    "to": 2,
    "total": 2
  }
}

Authorizations

​
Authorization
string
header
required

See the documentation for more information.

Path Parameters

​
charger_uuid
string
required

Body

application/json
​
date_from
string
required

Must be a valid date in the format Y-m-d H:i:s.

Example:

"2026-01-10 01:14:32"

​
date_to
string
required

Must be a valid date in the format Y-m-d H:i:s.

Example:

"2026-01-10 01:14:32"

​
context
enum<string>
Available options:
Interruption.Begin,
Interruption.End,
Other,
Sample.Clock,
Sample.Periodic,
Transaction.Begin,
Transaction.End,
Trigger
Example:

"Sample.Clock"

​
measurand
enum<string>
Available options:
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,
Voltage
Example:

"Energy.Reactive.Export.Register"

​
phase
enum<string>
Available options:
L1,
L2,
L3,
N,
L1-N,
L2-N,
L3-N,
L1-L2,
L2-L3,
L3-L1
Example:

"L1-N"

​
location
enum<string>
Available options:
Body,
Inlet,
Cable,
Outlet,
EV
Example:

"Body"

​
unit
enum<string>
Available options:
Wh,
kWh,
varh,
kvarh,
W,
kW,
VA,
kVA,
var,
kvar,
A,
V,
Celsius,
Fahrenheit,
K,
Percent
Example:

"VA"

​
limit
integer

Must not be greater than 10000.

Example:

1

​
order_by
enum<string>
Available options:
desc,
asc
Example:

"asc"

Response

200 - application/json
​
data
object[]
Example:
[
  {
    "id": 1,
    "charger_id": 1,
    "charger_connector_id": null,
    "charger_transaction_id": null,
    "timestamp": "2025-12-11T00:54:05.000000Z",
    "value": "11278",
    "context": "Transaction.Begin",
    "format": "Raw",
    "measurand": "Power.Factor",
    "phase": "L2-N",
    "location": "Body",
    "unit": "kWh"
  },
  {
    "id": 2,
    "charger_id": 2,
    "charger_connector_id": null,
    "charger_transaction_id": null,
    "timestamp": "2026-01-03T05:43:17.000000Z",
    "value": "18301",
    "context": "Interruption.Begin",
    "format": "Raw",
    "measurand": "Power.Active.Import",
    "phase": "L2",
    "location": "Outlet",
    "unit": "VA"
  }
]
​
links
object
​
meta
object