Get all drivers having access right to given sites
x-ms-visibility: "important"
Send a request to get all drivers that have charging rights to the sites' chargers
Request Body required
List of site ids to retrieve drivers for. The limit of ids that can be passed to this call is 20
- 200
- 400
- 401
- 404
Return the JSON representation of all the drivers authorised for the site
Schema
- Array [
- Array [
- Array [
- ]
- Array [
- Array [
- Array [
- ]
- Array [
- ]
- ]
- ]
- Array [
- Array [
- ]
- Array [
- ]
- ]
- Array [
- ]
- ]
- ]
users object[]
tags object[]
Invoicable is meaningful only if you have taken in use the invoicing service, default value is false
chargerGroups object[]
chargers object[]
locationInfo object
chargerConfigurations object[] nullable
sockets object[] nullable
Syntax according to eMI3 standard, for example: FRA23E45B*78C
if false, EVSE UID = chargerId; if true, EVSE UID = chargerId + socketId
customProperties object nullable
Possible values: [0
, 1
, 2
, 3
, 4
]
Default value: 0
chargers object[]
locationInfo object
chargerConfigurations object[] nullable
sockets object[] nullable
Syntax according to eMI3 standard, for example: FRA23E45B*78C
if false, EVSE UID = chargerId; if true, EVSE UID = chargerId + socketId
customProperties object nullable
integratedExternalIds object[]
Possible values: [0
, 1
]
Default value: 0
[
{
"groupId": 0,
"users": [
{
"id": 0,
"name": "string",
"homeGroupId": 0,
"homeGroupName": "string",
"externalId": "string",
"tags": [
{
"id": 0,
"idTag": "string",
"expiringDate": "2024-12-04T11:51:42.863Z",
"startDate": "2024-12-04T11:51:42.863Z",
"lastUpdated": "2024-12-04T11:51:42.863Z",
"tokenName": "string",
"invoicable": true
}
],
"chargerGroups": [
{
"onlineSocket": 0,
"offlineSocket": 0,
"errorSocket": 0,
"subgroups": [
null
],
"chargers": [
{
"id": 0,
"chargerId": "string",
"chargerName": "string",
"groupId": 0,
"groupName": "string",
"firmwareVersion": "string",
"publicGroupName": "string",
"manufacturer": "string",
"serialNumber": "string",
"chargerModel": "string",
"lastSeen": "2024-12-04T11:51:42.863Z",
"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-12-04T11:51:42.863Z",
"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,
"id": 0,
"groupName": "string",
"groupType": 0,
"externalId": "string"
}
],
"chargers": [
{
"id": 0,
"chargerId": "string",
"chargerName": "string",
"groupId": 0,
"groupName": "string",
"firmwareVersion": "string",
"publicGroupName": "string",
"manufacturer": "string",
"serialNumber": "string",
"chargerModel": "string",
"lastSeen": "2024-12-04T11:51:42.863Z",
"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-12-04T11:51:42.863Z",
"chargingStationEvseId": 0
}
],
"evseId": "string",
"splitEvseBySocket": true,
"capabilities": [
"string"
],
"physicalReference": "string",
"integrationRelays": [
"string"
],
"iccid": "string",
"imsi": "string",
"meterSerialNumber": "string",
"meterType": "string",
"customProperties": {}
}
],
"payerId": 0,
"integratedExternalIds": [
{
"referenceType": 0,
"referenceId": "string",
"externalId": "string",
"effectiveFrom": "2024-12-04T11:51:42.863Z"
}
]
}
]
}
]
[{"groupId":1,"users":[{"id":1,"name":"Jeff","homeGroupId":1,"homeGroupName":"homeGroup1"},{"id":2,"name":"Sam","homeGroupId":2,"homeGroupName":"homeGroup2"}]},{"groupId":2,"users":[{"id":4,"name":"Mark","homeGroupId":4,"homeGroupName":"homeGroup4"},{"id":5,"name":"Clark","homeGroupId":5,"homeGroupName":"homeGroup5"}]}]
Errors in the route parameters
Customer not found or not authorised
Site(s) not found for the customer or the site(s) have no drivers to return