Charging Stations (v1)

Download OpenAPI specification:Download

The Charging Stations API allows developers and integrators to access data related to your electric vehicle charging stations.

A charging station is a distinct entity in the EV charging infrastructure, capable of hosting multiple connectors to charge electric vehicles. Each charging station maintains an individual OCPP connection to ChargEye - managed in the background by the ChargEye platform. For Kempower satellite systems, a charging station is defined as the combined set of Power Units and Satellites, working together as a single functional unit. Each charging station is identified and managed as a separate entity within the ChargEye platform, and referenced with stationId.

Charging Stations API provides endpoints to retrieve detailed information on each charging station's availability, operational status, location, and connectors. Each connector’s data is enriched with charging session ("transaction") details, allowing you to monitor ongoing charging sessions or review data from the previous session if there's no active charging.

List Charging Stations

get/stations

Get a summary of all charging stations, including their availability, status, and location. Includes data on the connectors and associated transaction details.

SecuritybearerAuth
Request
query Parameters
locationUid
string

Return stations for this location

stationIds
Array of arrays

Return only these stations

Responses
200

OK

Response Schema: application/json
required
Array of objects (StationInfo)
Array
acDcPowerRatio
number

AC-DC conversion ratio

required
Array of objects (ConnectorInfo)
currentPowerA
number

Current intake at present (amperes) of the station

currentPowerKw
number

Current output power (kW) of the station

Array of objects or null (CeCommonLabel)
required
object
locationUid
string
maxPowerA
number

Maximum input current (amperes) of the station that it could theoretically take with current configuration. Equals to PMC input supply current. Dynamic limits (charging profiles) do not affect this.

maxPowerKw
number

MAX output power (kW) of the station undefined if not known

name
required
string
onlineStatus
required
string
Enum: "Offline" "Online"
powerGroupParentPath
Array of strings

Path in powerGroup tree, 0th value is the id of root. This station does not belong to a power group if this is null/empty

stationCapabilities
string or null

Capabilities that the station supports as a comma separated list. For example when station supports serial connectable power modules, contents would be: stationCapabilities = "SerialConnection,Xxx, ... ,Yyy"

stationId
required
string
status
required
string (ChargingStationStatus)
Enum: "Faulted" "Operative" "Unavailable"
401

Unauthorized - Authorization: Bearer header is missing, invalid, expired, or user has no permission

Request samples 
Response samples 
application/json
{
  • "stations": [
    ]
}
Get a Charging Station
get/stations/{stationId}
Returns information on a specific station, including real-time status and location.
Detailed information on each connector and ongoing or last completed transaction are included.


Obtain the stationId from the List Charging Stations endpoint to use this operation.


SecuritybearerAuth 
Request 
path Parameters
stationId
required
string
 
Responses 
200
OK


Response Schema: application/json
acDcPowerRatio
number
AC-DC conversion ratio


 
required
Array of objects (ConnectorInfo) 
 
 Array 
connectorId
required
string
 
required
object (TxInfo) 
 
maxPowerKw
required
number
 
maxPowerKwActual
required
number
 
name
required
string
 
status
required
string (EVSEStatus) 
 Enum: "Available" "Charging" "Faulted" "Occupied" "Reserved" "Unavailable" "Unknown"  
type
required
string (EVSEType) 
 Enum: "AC" "CCS" "CHAdeMO" "Type2" "oppcharge"  
currentPowerA
number
Current intake at present (amperes) of the station


 
currentPowerKw
number
Current output power (kW) of the station


 
Array of objects or null (CeCommonLabel) 
 
 Array 
tenantIds
Array of strings or null
 
value
required
string
 
required
object
 
address
required
string
 
lat
required
number
 
lng
required
number
 
name
required
string
 
locationUid
string
 
maxPowerA
number
Maximum input current (amperes) of the station
that it could theoretically take with current configuration.
Equals to PMC input supply current.
Dynamic limits (charging profiles) do not affect this.


 
maxPowerKw
number
MAX output power (kW) of the station undefined if not known


 
name
required
string
 
onlineStatus
required
string
 Enum: "Offline" "Online"  
powerGroupParentPath
Array of strings
Path in powerGroup tree, 0th value is the id of root. This station does not belong to a power group if this is null/empty


 
stationCapabilities
string or null
Capabilities that the station supports as a comma separated list.
For example when station supports serial connectable power modules,
contents would be:
stationCapabilities = "SerialConnection,Xxx, ... ,Yyy"


 
stationId
required
string
 
status
required
string (ChargingStationStatus) 
 Enum: "Faulted" "Operative" "Unavailable"  
401
Unauthorized - Authorization: Bearer header is missing, invalid, expired, or user has no permission


Request samples 
Response samples 
application/json
{
  • "stationId": "CSt_EZKpa3R",
  • "powerGroupParentPath": [ ],
  • "name": "TRLLY Charger",
  • "maxPowerKw": 50,
  • "currentPowerKw": 0,
  • "maxPowerA": 62,
  • "currentPowerA": 0,
  • "acDcPowerRatio": 0.87,
  • "location": {
    },
  • "status": "Operative",
  • "onlineStatus": "Online",
  • "connectors": [
    ]
}