Get a single site with its subsites and chargers
x-ms-visibility: "important"
Send a request to get a single site by its external id. Its subsites and chargers are included.
Path Parameters
externalId string required
This is id from an external system for the site
Query Parameters
excludeSubgroups string
If false, all the subsites are included in the reply. If true, no subsite data is added. Default if omitted: false
Responses
- 200
- 400
- 401
- 404
Returns the JSON representation of the site with all its subsites and chargers
application/json
Schema
Example (from schema)
example
Schema
- Array [
- Array [
- ]
- Array [
- ]
- ]
- Array [
- ]
streetAddress string
postalNumber string
city string
area string
country string
latitude double nullable
longitude double nullable
onlineSocket int32
offlineSocket int32
errorSocket int32
subgroups undefined[]
chargers object[]
dlmGroupId int64 nullable
id int64 nullable
chargerId string
chargerName string
groupId int64
groupName string
firmwareVersion string nullable
publicGroupName string nullable
manufacturer string nullable
serialNumber string nullable
chargerModel string nullable
amountOfSockets int32 deprecated
lastSeen date-time
lastMessage string nullable
activeConnection boolean
chargerStatus string
locationInfo object
latitude double
longitude double
streetAddress string nullable
streetNumber string
houseLetter string nullable
postalNumber string
city string nullable
area string nullable
country string nullable
pushIntegrationEnabled boolean
chargerSpecificMessageStructure boolean
chargerConfigurations object[] nullable
configName string
configValue string
canBeChanged boolean
sockets object[] nullable
type string nullable
maxPower string nullable
status string
id int32
name string
deviceEvseId int32 nullable
deviceConnectorId int32 nullable
format string nullable
socketPowerType string nullable
maxWatts int32 nullable
maxVoltage int32 nullable
maxAmperage int32 nullable
phaseRotation string nullable
termsAndConditions uri nullable
lastUpdated date-time
chargingStationEvseId int32 nullable
evseId string
Syntax according to eMI3 standard, for example: FRA23E45B*78C
splitEvseBySocket boolean
if false, EVSE UID = chargerId; if true, EVSE UID = chargerId + socketId
capabilities string[]
physicalReference string nullable
integrationRelays string[] nullable
iccid string nullable
imsi string nullable
meterSerialNumber string nullable
meterType string nullable
customProperties object nullable
property name* string
payerId int64 nullable
costId string
costName string
paymentRecipientId int64 nullable
dlmGroupId int64 nullable
publicName string
timezone string
publish boolean nullable
parkingType int32 nullable
Possible values: [0
, 1
, 2
, 3
, 4
, 5
, 6
, 7
]
Default value: 0
parentId int64 nullable
tariffReferences object[]
tariffId string
usageType int32
Possible values: [0
, 1
]
Default value: 0
id int64
groupName string
groupType int32 nullable
Possible values: [0
, 1
, 2
, 3
, 4
]
Default value: 0
externalId string
{
"streetAddress": "string",
"postalNumber": "string",
"city": "string",
"area": "string",
"country": "string",
"latitude": 0,
"longitude": 0,
"onlineSocket": 0,
"offlineSocket": 0,
"errorSocket": 0,
"subgroups": [
null
],
"chargers": [
{
"dlmGroupId": 0,
"id": 0,
"chargerId": "string",
"chargerName": "string",
"groupId": 0,
"groupName": "string",
"firmwareVersion": "string",
"publicGroupName": "string",
"manufacturer": "string",
"serialNumber": "string",
"chargerModel": "string",
"lastSeen": "2024-10-10T06:49:37.432Z",
"lastMessage": "string",
"activeConnection": true,
"chargerStatus": "string",
"locationInfo": {
"latitude": 0,
"longitude": 0,
"streetAddress": "string",
"streetNumber": "string",
"houseLetter": "string",
"postalNumber": "string",
"city": "string",
"area": "string",
"country": "string"
},
"pushIntegrationEnabled": true,
"chargerSpecificMessageStructure": true,
"chargerConfigurations": [
{
"configName": "string",
"configValue": "string",
"canBeChanged": true
}
],
"sockets": [
{
"type": "string",
"maxPower": "string",
"status": "string",
"id": 0,
"name": "string",
"deviceEvseId": 0,
"deviceConnectorId": 0,
"format": "string",
"socketPowerType": "string",
"maxWatts": 0,
"maxVoltage": 0,
"maxAmperage": 0,
"phaseRotation": "string",
"termsAndConditions": "string",
"lastUpdated": "2024-10-10T06:49:37.432Z",
"chargingStationEvseId": 0
}
],
"evseId": "string",
"splitEvseBySocket": true,
"capabilities": [
"string"
],
"physicalReference": "string",
"integrationRelays": [
"string"
],
"iccid": "string",
"imsi": "string",
"meterSerialNumber": "string",
"meterType": "string",
"customProperties": {}
}
],
"payerId": 0,
"costId": "string",
"costName": "string",
"paymentRecipientId": 0,
"dlmGroupId": 0,
"publicName": "string",
"timezone": "string",
"publish": true,
"parkingType": 0,
"parentId": 0,
"tariffReferences": [
{
"tariffId": "string",
"usageType": 0
}
],
"id": 0,
"groupName": "string",
"groupType": 0,
"externalId": "string"
}
{"id":1,"groupName":"SiteTest","onlineSocket":3,"offlineSocket":1,"errorSocket":0,"payerId":5,"costId":"12345","paymentRecipientId":33,"groupType":"SITE","dlmGroupId":33,"latitude":60.16734,"longitude":24.92173,"streetAddress":"Long Street","city":"The City","postalNumber":"12345","country":"Some country","externalId":"IdFromSomewhere","publicName":"Name to use in public","timezone":"Europe/Brussels","publish":true,"parkingType":"OTHER","subgroups":"here list of subsites","chargers":"here list of chargers"}
Errors in the route parameters
Customer not found or not authorised
Site not found for the customer
Loading...