Get a single driver using idTag

x-ms-visibility: "important"

Send a request to get a single driver by its idTag

Path Parameters

idTag string required

This is the one of the tags 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

id int64
name string
homeGroupId int64
homeGroupName string
externalId string
tags object[]
Array [
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[]
Array [
onlineSocket int32 nullable
offlineSocket int32 nullable
errorSocket int32 nullable
subgroups undefined[]
chargers object[]
Array [
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
Array [
configName string
configValue string
canBeChanged boolean
]
sockets object[] nullable
Array [
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[]
Array [
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
Array [
configName string
configValue string
canBeChanged boolean
]
sockets object[] nullable
Array [
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[]
Array [
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-12-04T11:51:42.899Z",
      "startDate": "2024-12-04T11:51:42.899Z",
      "lastUpdated": "2024-12-04T11:51:42.899Z",
      "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.900Z",
          "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.900Z",
              "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.900Z",
      "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.900Z",
          "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.900Z"
    }
  ]
}

{"id":1,"name":"DriverTest","homeGroupId":3,"homeGroupName":"homeOne","externalId":"extIdTest","tags":"here the list of tags","groups":"here list of sites","chargers":"here list of chargers","payerId":4}

Errors in the route parameters

Customer not found or not authorised

Driver not found in the list of drivers of the customer

Loading...