Get a single driver
x-ms-visibility: "important"
Send a request to get a single driver by its id
Path Parameters
userid int32 required
This is the globally unique ID for the driver
Responses
- 200
- 400
- 401
- 404
Return the JSON representation of the driver with all its sites, chargers and tags
application/json
Schema
Example (from schema)
response
Schema
- Array [
- ]
- Array [
- Array [
- Array [
- ]
- Array [
- ]
- ]
- ]
- Array [
- Array [
- ]
- Array [
- ]
- ]
- Array [
- ]
id int64
name string
homeGroupId int64
homeGroupName string
externalId string
tags object[]
id int64
idTag string
expiringDate date-time
startDate date-time nullable
lastUpdated date-time nullable
tokenName string
invoicable boolean
Invoicable is meaningful only if you have taken in use the invoicing service, default value is false
chargerGroups object[]
onlineSocket int32 nullable
offlineSocket int32 nullable
errorSocket int32 nullable
subgroups undefined[]
chargers object[]
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
id int64
groupName string
groupType int32 nullable
Possible values: [0
, 1
, 2
, 3
, 4
]
Default value: 0
externalId string
chargers object[]
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
integratedExternalIds object[]
referenceType int32
Possible values: [0
, 1
]
Default value: 0
referenceId string
externalId string
effectiveFrom date-time nullable
{
"id": 0,
"name": "string",
"homeGroupId": 0,
"homeGroupName": "string",
"externalId": "string",
"tags": [
{
"id": 0,
"idTag": "string",
"expiringDate": "2024-10-10T06:49:37.442Z",
"startDate": "2024-10-10T06:49:37.442Z",
"lastUpdated": "2024-10-10T06:49:37.442Z",
"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-10-10T06:49:37.442Z",
"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.442Z",
"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-10-10T06:49:37.442Z",
"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.442Z",
"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-10-10T06:49:37.442Z"
}
]
}
{"id":1,"name":"UserTest","homeGroupId":3,"homeGroupName":"homeOne","externalId":"extIdTest","tags":"here the list of tags","chargerGroups":"here list of sites","chargers":"here list of chargers","payerId":4,"integratedExternalIds":"here list of externalIds"}
Errors in the route parameters
text/plain
Schema
Schema
string
Customer not found or not authorised
Driver not found for the customer
Loading...