Get Power Management
curl --request GET \
--url https://app.plugchoice.com/api/v3/sites/{site}/power-management \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.plugchoice.com/api/v3/sites/{site}/power-management"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.plugchoice.com/api/v3/sites/{site}/power-management', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.plugchoice.com/api/v3/sites/{site}/power-management",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.plugchoice.com/api/v3/sites/{site}/power-management"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.plugchoice.com/api/v3/sites/{site}/power-management")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.plugchoice.com/api/v3/sites/{site}/power-management")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"groups": [
{
"id": 123,
"isRoot": true,
"totalAmps": 123,
"netType": "<string>",
"method": "<string>",
"peakShaving": {
"enabled": true,
"threshold": 123
},
"meter": {
"id": 123,
"uuid": "<string>",
"type": "<string>",
"serialNumber": "<string>"
},
"solarSettings": {
"additionalAmps": 123,
"alwaysCharge": true,
"alwaysChargeAmps": 123,
"smartChargingChargeOnSolarExport": true
},
"dataKeys": {},
"chargers": [
{}
],
"subgroups": [
{}
]
}
],
"unattachedChargers": [
{
"id": 123,
"uuid": "<string>",
"label": "<string>",
"status": "<string>",
"maxCurrent": 123,
"hasSmartLicense": true,
"connectors": [
{
"id": 123,
"chargerId": 123,
"connectorId": 123,
"status": "<string>",
"phaseRotation": "<string>",
"maxAmperage": 123,
"minCurrent": 123,
"currentLimit": 123,
"currentLimitManagedBy": "<string>",
"powerType": "<string>",
"standard": "<string>",
"format": "<string>",
"maxVoltage": 123,
"dataKeys": {}
}
]
}
],
"allChargers": [
{
"id": 123,
"uuid": "<string>",
"label": "<string>",
"status": "<string>",
"groupId": 123
}
],
"realTimeData": {},
"meterData": {}
}
}Power Management
Get Power Management
GET
/
v3
/
sites
/
{site}
/
power-management
Get Power Management
curl --request GET \
--url https://app.plugchoice.com/api/v3/sites/{site}/power-management \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.plugchoice.com/api/v3/sites/{site}/power-management"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.plugchoice.com/api/v3/sites/{site}/power-management', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.plugchoice.com/api/v3/sites/{site}/power-management",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.plugchoice.com/api/v3/sites/{site}/power-management"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.plugchoice.com/api/v3/sites/{site}/power-management")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.plugchoice.com/api/v3/sites/{site}/power-management")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"groups": [
{
"id": 123,
"isRoot": true,
"totalAmps": 123,
"netType": "<string>",
"method": "<string>",
"peakShaving": {
"enabled": true,
"threshold": 123
},
"meter": {
"id": 123,
"uuid": "<string>",
"type": "<string>",
"serialNumber": "<string>"
},
"solarSettings": {
"additionalAmps": 123,
"alwaysCharge": true,
"alwaysChargeAmps": 123,
"smartChargingChargeOnSolarExport": true
},
"dataKeys": {},
"chargers": [
{}
],
"subgroups": [
{}
]
}
],
"unattachedChargers": [
{
"id": 123,
"uuid": "<string>",
"label": "<string>",
"status": "<string>",
"maxCurrent": 123,
"hasSmartLicense": true,
"connectors": [
{
"id": 123,
"chargerId": 123,
"connectorId": 123,
"status": "<string>",
"phaseRotation": "<string>",
"maxAmperage": 123,
"minCurrent": 123,
"currentLimit": 123,
"currentLimitManagedBy": "<string>",
"powerType": "<string>",
"standard": "<string>",
"format": "<string>",
"maxVoltage": 123,
"dataKeys": {}
}
]
}
],
"allChargers": [
{
"id": 123,
"uuid": "<string>",
"label": "<string>",
"status": "<string>",
"groupId": 123
}
],
"realTimeData": {},
"meterData": {}
}
}Returns the power management status for the specified location, including the hierarchical group structure, chargers, connectors, and real-time metrics for load management visualization.
string
required
The UUID of the location.
Response
object
The power management payload.
Show data
Show data
array
An array of top-level load balancing group objects.
Show group object
Show group object
integer
The numeric ID of the group.
boolean
Whether this is a root-level group.
integer
The total available amperage for the group.
string
The electrical network type (e.g.,
TT, TN, IT).string
The load balancing method.
object
object
object
object
A map of Redis key names for the group’s real-time available, requested, and allocated amperage per phase, plus the
meter key (or null when no meter is attached).array
An array of charger objects assigned to this group. Each charger has the same structure as the entries in
unattachedChargers.array
An array of nested subgroup objects (same structure as group).
array
An array of chargers not assigned to any group.
Show charger object
Show charger object
integer
The numeric ID of the charger.
string
The UUID of the charger.
string
The charger’s identity label.
string
The connection status of the charger.
integer
The maximum current of the charger.
boolean
Whether the charger has a smart charging license.
array
An array of connector objects for this charger.
Show connector object
Show connector object
integer
The numeric ID of the connector.
integer
The numeric ID of the parent charger.
integer
The OCPP connector ID on the charger.
string
The connector status.
string
The phase rotation (e.g.,
RST).integer
The maximum amperage for the connector.
integer
The minimum current for the connector.
integer
The configured current limit, or
null.string
What set the current limit. One of
api or user, or null when not set.string
The power type of the connector, or
null.string
The connector standard, or
null.string
The connector format, or
null.integer
The maximum voltage for the connector, or
null.object
A map of Redis key names for the connector’s real-time requested/allocated amperage per phase and power usage.
array
object
A map of data keys to their current values for real-time load management metrics (available, requested, and allocated amperage per phase).
object
A map of meter IDs to their current power readings.
⌘I