List Connectors
curl --request GET \
--url https://app.plugchoice.com/api/v3/sites/{site}/connectors \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.plugchoice.com/api/v3/sites/{site}/connectors"
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}/connectors', 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}/connectors",
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}/connectors"
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}/connectors")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.plugchoice.com/api/v3/sites/{site}/connectors")
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{
"id": 123,
"charger_id": 123,
"connector_id": 123,
"status": "<string>",
"error": "<string>",
"error_info": "<string>",
"vendor_id": "<string>",
"vendor_error_code": "<string>",
"max_amperage": 123,
"min_current": 123,
"current_limit": 123,
"current_limit_managed_by": "<string>",
"max_voltage": 123,
"standard": "<string>",
"format": "<string>",
"power_type": "<string>",
"phase_rotation": "<string>",
"charger": {
"uuid": "<string>",
"id": 123,
"identity": "<string>",
"serial_number": "<string>",
"pincode": "<string>",
"reference": "<string>",
"connection_status": "<string>",
"status": "<string>",
"error": "<string>",
"error_info": "<string>",
"vendor_id": "<string>",
"vendor_error_code": "<string>",
"firmware_version": "<string>",
"parsed_firmware_version": "<string>",
"server": "<string>",
"last_connection_at": "<string>",
"last_disconnection_at": "<string>",
"last_heartbeat_at": "<string>",
"setup_pending": true,
"setup_completed": true,
"blocked": true,
"max_current": 123,
"created_at": "<string>",
"updated_at": "<string>",
"licenses": {
"smart": true,
"pro": true
},
"model_id": 123,
"is_mid": true,
"permissions": {}
},
"created_at": "<string>",
"updated_at": "<string>"
}Connectors
List Connectors
GET
/
v3
/
sites
/
{site}
/
connectors
List Connectors
curl --request GET \
--url https://app.plugchoice.com/api/v3/sites/{site}/connectors \
--header 'Authorization: Bearer <token>'import requests
url = "https://app.plugchoice.com/api/v3/sites/{site}/connectors"
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}/connectors', 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}/connectors",
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}/connectors"
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}/connectors")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.plugchoice.com/api/v3/sites/{site}/connectors")
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{
"id": 123,
"charger_id": 123,
"connector_id": 123,
"status": "<string>",
"error": "<string>",
"error_info": "<string>",
"vendor_id": "<string>",
"vendor_error_code": "<string>",
"max_amperage": 123,
"min_current": 123,
"current_limit": 123,
"current_limit_managed_by": "<string>",
"max_voltage": 123,
"standard": "<string>",
"format": "<string>",
"power_type": "<string>",
"phase_rotation": "<string>",
"charger": {
"uuid": "<string>",
"id": 123,
"identity": "<string>",
"serial_number": "<string>",
"pincode": "<string>",
"reference": "<string>",
"connection_status": "<string>",
"status": "<string>",
"error": "<string>",
"error_info": "<string>",
"vendor_id": "<string>",
"vendor_error_code": "<string>",
"firmware_version": "<string>",
"parsed_firmware_version": "<string>",
"server": "<string>",
"last_connection_at": "<string>",
"last_disconnection_at": "<string>",
"last_heartbeat_at": "<string>",
"setup_pending": true,
"setup_completed": true,
"blocked": true,
"max_current": 123,
"created_at": "<string>",
"updated_at": "<string>",
"licenses": {
"smart": true,
"pro": true
},
"model_id": 123,
"is_mid": true,
"permissions": {}
},
"created_at": "<string>",
"updated_at": "<string>"
}Returns a paginated list of all connectors across all chargers for the specified location. Each connector includes its parent charger information. Results are paginated with 25 items per page.
string
required
The UUID of the location.
Response
integer
The numeric ID of the connector.
integer
The ID of the parent charger.
integer
The OCPP connector ID.
string
The current connector status.
string
The current error code, if any.
string
Additional error information, if any.
string
The vendor identifier.
string
The vendor-specific error code, if any.
integer
The maximum amperage of the connector.
integer
The minimum current of the connector.
integer
The current limit of the connector.
string
Identifies what is currently managing the connector’s current limit. May be
null.integer
The maximum voltage of the connector.
string
The connector standard (e.g., IEC 62196).
string
The connector format (e.g., Socket, Cable).
string
The power type (e.g., AC_1_PHASE, AC_3_PHASE, DC).
string
The phase rotation configuration.
object
The parent charger object.
Show charger
Show charger
string
The unique UUID of the charger.
integer
The numeric ID of the charger.
string
The charger’s OCPP identity string.
string
The charger’s serial number.
string
The charger’s pincode. Only included when the authenticated user has permission to view sensitive data.
string
A custom reference label for the charger, or
null if none is set.string
The current connection status of the charger.
string
The current OCPP status of the charger.
string
The current error code, if any.
string
Additional error information, if any.
string
The vendor identifier.
string
The vendor-specific error code, if any.
string
The charger’s firmware version string.
string
The parsed firmware version, or
null if unparseable.string
The OCPP server the charger is connected to.
string
ISO 8601 timestamp of the last connection.
string
ISO 8601 timestamp of the last disconnection.
string
ISO 8601 timestamp of the last heartbeat.
boolean
Whether the charger has a pending setup.
boolean
Whether the charger setup is completed.
boolean
Whether the charger is blocked.
integer
The maximum current in amps.
string
ISO 8601 timestamp of when the charger was created.
string
ISO 8601 timestamp of when the charger was last updated.
object
integer
The ID of the charger’s model.
boolean
Whether the charger is a MID-certified (metering compliant) model.
object
The authenticated user’s permissions for this charger.
string
ISO 8601 timestamp of when the connector was created.
string
ISO 8601 timestamp of when the connector was last updated.
⌘I