Get a cluster's live status
curl --request GET \
--url https://api.ridergy.com/v1/clusters/{clusterId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.ridergy.com/v1/clusters/{clusterId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ridergy.com/v1/clusters/{clusterId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.ridergy.com/v1/clusters/{clusterId}"
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))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ridergy.com/v1/clusters/{clusterId}",
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;
}HttpResponse<String> response = Unirest.get("https://api.ridergy.com/v1/clusters/{clusterId}")
.header("Authorization", "Bearer <token>")
.asString();{
"clusterId": "clst_20260612_a1b2c3d4",
"tenantUuid": "<string>",
"name": "North Campus",
"locationIds": [
"3632155",
"3632156"
],
"limitKw": 200,
"status": "ACTIVE",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"liveStatus": {
"actualTotalKw": 130.8,
"clusterLimitKw": 200,
"sumLocationLimits": 200,
"withinLimit": true,
"locations": [
{
"locationId": "3632155",
"setLimitKw": 100,
"effectiveLimitKw": 80,
"actualKw": 65.4,
"maxKw": 150
}
]
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or expired token",
"requestId": "b1f6e6b0-1234-4abc-9def-000000000000"
}
}{
"error": {
"code": "FEATURE_NOT_ENABLED",
"message": "The Energy Management API is not enabled for your account. Contact RiDERgy to enable this feature.",
"requestId": "b1f6e6b0-1234-4abc-9def-000000000000"
}
}{
"error": {
"code": "CLUSTER_NOT_FOUND",
"message": "Cluster clst_20260612_a1b2c3d4 not found",
"requestId": "b1f6e6b0-1234-4abc-9def-000000000000"
}
}Clusters
Live status van een cluster ophalen
Geeft het cluster terug plus een liveStatus-blok: werkelijke totale
kW-belasting, som van de limieten van de lidlocaties, en per locatie
{setLimitKw, effectiveLimitKw, actualKw, maxKw} na proportionele
schaling (scale = min(1, clusterLimitKw / sumLocationLimits)).
GET
/
clusters
/
{clusterId}
Get a cluster's live status
curl --request GET \
--url https://api.ridergy.com/v1/clusters/{clusterId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.ridergy.com/v1/clusters/{clusterId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ridergy.com/v1/clusters/{clusterId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.ridergy.com/v1/clusters/{clusterId}"
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))
}<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ridergy.com/v1/clusters/{clusterId}",
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;
}HttpResponse<String> response = Unirest.get("https://api.ridergy.com/v1/clusters/{clusterId}")
.header("Authorization", "Bearer <token>")
.asString();{
"clusterId": "clst_20260612_a1b2c3d4",
"tenantUuid": "<string>",
"name": "North Campus",
"locationIds": [
"3632155",
"3632156"
],
"limitKw": 200,
"status": "ACTIVE",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"liveStatus": {
"actualTotalKw": 130.8,
"clusterLimitKw": 200,
"sumLocationLimits": 200,
"withinLimit": true,
"locations": [
{
"locationId": "3632155",
"setLimitKw": 100,
"effectiveLimitKw": 80,
"actualKw": 65.4,
"maxKw": 150
}
]
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or expired token",
"requestId": "b1f6e6b0-1234-4abc-9def-000000000000"
}
}{
"error": {
"code": "FEATURE_NOT_ENABLED",
"message": "The Energy Management API is not enabled for your account. Contact RiDERgy to enable this feature.",
"requestId": "b1f6e6b0-1234-4abc-9def-000000000000"
}
}{
"error": {
"code": "CLUSTER_NOT_FOUND",
"message": "Cluster clst_20260612_a1b2c3d4 not found",
"requestId": "b1f6e6b0-1234-4abc-9def-000000000000"
}
}Autorisaties
OAuth 2.0-toegangstoken verkregen via POST /oauth/token met client_credentials-grant.
Tenant en scopes zijn ingebed in de JWT, er zijn geen extra headers nodig.
Padparameters
De unieke ID van de cluster, geretourneerd bij het aanmaken van de cluster.
Respons
Clusterdetail met live status
Voorbeeld:
"clst_20260612_a1b2c3d4"
Voorbeeld:
"North Campus"
Voorbeeld:
["3632155", "3632156"]
Voorbeeld:
200
Beschikbare opties:
ACTIVE, INACTIVE Show child attributes
Show child attributes

