Status Information of Charging Station

Allows to retrieve current status information of a charging station. The response consists of an array of objects for each plug of the charging station, as some charging stations have multiple plugs. It contains the plug_uuid and plug_label identifying the plug and the evse_uuid, identifying the charging station (same for each plug). The fields current_l1, current_l2, current_l3, and dyn_current_limit are given in ampere. The power field is given in watts.

GET

https://cloud.clemap.com:3032/edgeDevices/{edge_device_id}/evses/{uuid}/status

Header Parameters

evsetokenstringrequired
Description
EVSE authentication token for the specific charging station.

curl

curl --location --globoff '/edgeDevices/{edge_device_id}/evses/{uuid}/status' \
--header 'evsetoken: string'

nodejs

var request = require('request');
var options = {
   'method': 'GET',
   'url': '/edgeDevices/{edge_device_id}/evses/{uuid}/status',
   'headers': {
      'evsetoken': 'string'
   }
};
request(options, function (error, response) {
   if (error) throw new Error(error);
   console.log(response.body);
});

javascript

var myHeaders = new Headers();
myHeaders.append("evsetoken", "string");

var requestOptions = {
   method: 'GET',
   headers: myHeaders,
   redirect: 'follow'
};

fetch("/edgeDevices/{edge_device_id}/evses/{uuid}/status", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

python

import requests

url = "/edgeDevices/{edge_device_id}/evses/{uuid}/status"

payload = {}
headers = {
   'evsetoken': 'string'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

ruby

require "uri"
require "net/http"

url = URI("/edgeDevices/{edge_device_id}/evses/{uuid}/status")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Get.new(url)
request["evsetoken"] = "string"

response = http.request(request)
puts response.read_body

200

[
    {
      "time": "2024-03-25T11:12:17.851Z",
      "plug_uuid": "6bbf9fd56dc24f9697b078d5d8ccda84",
      "plug_label": "Plug 1",
      "evse_uuid": "25104c56d7f848af830af4300193efb3",
      "status": "idle",
      "current_l1": 0,
      "current_l2": 0,
      "current_l3": 0,
      "power": 0,
      "dyn_current_limit": 6,
    },
    {
      "time": "2024-03-25T11:12:17.851Z",
      "plug_uuid": "c99838f9eb5b423d98f8ba33389a255c",
      "plug_label": "Plug 2",
      "evse_uuid": "25104c56d7f848af830af4300193efb3",
      "status": "charging",
      "current_l1": 10.3,
      "current_l2": 10.3,
      "current_l3": 10.3,
      "power": 7107.0,
      "dyn_current_limit": 12,
    }
]

Possible Status Values

Status	Description
charging	Charging station is charging a vehicle
recently_started_charging	Charging station has recently started a charging session
idle	Charging station is idle and waiting for a command
connected	Vehicle is connected but not charging
discharging	Resource is discharging and supplying power to the grid
error	Charging station is in an error state, control is not possible
offline	Charging station cannot be reached
cloud_offline	CLEMAP device cannot reach CLEMAP cloud
init	During initialization
stopped	Charging station is stopped
starting	Charging station is starting
producing	For PV systems only, irrelevant for EV charging stations
unknown	Unknown status