Get chargers
x-ms-visibility: "important"
Retrieve a list of all chargers associated with the user.
Query Parameters
Page to be fetched. Default: 1
Limit (No. of records per page). Max value: 100. Default: 100.
Sort field to be used. Default: 'ChargerId'
Set to 'true' to sort descending based on sort key. Default: 'false' Available sort keys: chargerId, name, lastSeen, activeConnection, model, manufacturer.
Filter chargers by site ID.
Include chargers from subsites.
Filter chargers by external site ID.
Filter chargers by manufacturer.
Filter chargers by model.
Filter chargers by socket state.
Free text filter for charger name, manufacturer, model, address.
Include charger configurations in the response.
- 200
- 400
- 401
List of chargers accessible by the user.
Schema
- Array [
- Array [
- ]
- Array [
- ]
- Array [
- ]
- ]
items object[]
Possible values: [0
, 1
, 2
, 3
, 4
, 5
, 6
, 7
, 8
, 9
, 10
, 11
]
Default value: 0
sockets object[]
location object
Possible values: [CHARGING_PROFILE_CAPABLE
, CHARGING_PREFERENCES_CAPABLE
, CHIP_CARD_SUPPORT
, CONTACTLESS_CARD_SUPPORT
, CREDIT_CARD_PAYABLE
, DEBIT_CARD_PAYABLE
, PED_TERMINAL
, REMOTE_START_STOP_CAPABLE
, RESERVABLE
, RFID_READER
, START_SESSION_CONNECTOR_REQUIRED
, TOKEN_GROUP_CAPABLE
, UNLOCK_CAPABLE
]
chargerConfigurations object[]
ongoingTransactions object[]
customProperties object
{
"page": 0,
"limit": 0,
"totalRecords": 0,
"hasNextPage": true,
"hasPreviousPage": true,
"items": [
{
"id": 0,
"chargerId": "string",
"name": "string",
"state": 0,
"lastMessage": "string",
"lastSeen": "2025-04-10T07:03:12.583Z",
"siteId": 0,
"siteName": "string",
"model": "string",
"manufacturer": "string",
"firmware": "string",
"serial": "string",
"activeConnection": true,
"iccid": "string",
"imsi": "string",
"meterType": "string",
"meterSerialNumber": "string",
"pushIntegrationEnabled": true,
"chargerSpecificMessageStructure": true,
"evseId": "string",
"splitEvseBySocket": true,
"physicalReference": "string",
"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:03:12.583Z",
"chargingStationEvseId": 0,
"parkingPlace": "string"
}
],
"location": {
"latitude": 0,
"longitude": 0,
"streetAddress": "string",
"streetNumber": "string",
"houseLetter": "string",
"postalNumber": "string",
"city": "string",
"area": "string",
"country": "string"
},
"capabilities": [
"CHARGING_PROFILE_CAPABLE"
],
"chargerConfigurations": [
{
"configName": "string",
"configValue": "string",
"canBeChanged": true
}
],
"ongoingTransactions": [
{
"socketId": 0,
"transactionId": 0,
"evseTransactionId": "string"
}
],
"customProperties": {},
"integrationRelays": [
"string"
],
"metadata": [
"string"
],
"installationDate": "2025-04-10T07:03:12.583Z",
"parkingPlace": "string",
"serviceCompany": "string",
"serviceContactPerson": "string",
"servicePhoneNumber": "string",
"serviceEmail": "string",
"notes": "string"
}
]
}
Exception Details
Schema
{
"errorCode": "string",
"message": "string",
"errorNumber": 0,
"helpLink": "string"
}
User not authorised