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
This is id from an external system for the site
Query Parameters
If false, all the subsites are included in the reply. If true, no subsite data is added. Default if omitted: false
- 200
- 400
- 401
- 404
Returns the JSON representation of the site with all its subsites and chargers
Schema
- Array [
- Array [
- ]
- Array [
- ]
- ]
- Array [
- ]
chargers object[]
locationInfo object
chargerConfigurations object[] nullable
sockets object[] nullable
Syntax according to eMI3 standard, for example: FRA23E45B78C
if false, EVSE UID = chargerId; if true, EVSE UID = chargerId + socketId
customProperties object nullable
Possible values: [ALONG_MOTORWAY
, PARKING_GARAGE
, PARKING_LOT
, ON_DRIVEWAY
, ON_STREET
, UNDERGROUND_GARAGE
, OTHER
, UNKNOWN
]
Default value: ALONG_MOTORWAY
tariffReferences object[]
Possible values: [SITE_INVOICING
, PAYMENT_TERMINAL
]
Default value: SITE_INVOICING
Possible values: [SUB_CPO
, SITE
, SUB_SITE
, CIRCUIT
, OTHER
]
Default value: SUB_CPO
{
"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": "2025-04-10T07:02:58.396Z",
"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": "2025-04-10T07:02:58.396Z",
"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": "ALONG_MOTORWAY",
"parentId": 0,
"tariffReferences": [
{
"tariffId": "string",
"usageType": "SITE_INVOICING"
}
],
"id": 0,
"groupName": "string",
"groupType": "SUB_CPO",
"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