Skip to content
/
Get connectivity informat...

Get connectivity information for an EVSE

Request

Returns a snapshot of the EVSE's connectivity metrics including signal strength, SIM data, firmware version, and connection reliability.

Security
oauth2(Required scopes: evse:read)
Path
evse_idstringevse[A-Z\d]{26}required

The ID of the specific EVSE to retrieve.

Example:evse01HSH04KDEWF6Z4DB2J77J74K5
Query
expandArray of strings

Specify a url field to expand into a nested resource.

Items Value:"latest_status_log"
Headers
EvEnergy-Versionnumber

Specify the version of this endpoint to use.

Value:2
curl -i -X GET \
  'https://developers.ev.energy/_mock/ev.energy-api-v2/evses/evse01HSH04KDEWF6Z4DB2J77J74K5/connectivity?expand=latest_status_log' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'EvEnergy-Version: 2'

Responses

Returns the connectivity information for this EVSE.

Headers
EvEnergy-Versionnumber

Indicates the version of the API that generated this response. If EvEnergy-Version was not specified in the request, this will be your OAuth application's default version.

Value:2
X-RateLimit-Limitnumber

The maximum number of requests that can be made to this endpoint per hour. Defaults to 1000 but may vary per client.

Default:1000
X-RateLimit-Remainingnumber

The number of requests remaining until this client's rate limit is reached.

Default:999
RetryAfternumber

The number of seconds until this client's requests will not be rate limited.

Default:3600
Bodyapplication/json
signal_strength_rssi_dbminteger or nullread-onlyrequired

Last known signal strength in RSSI dBm. Null for WiFi EVSEs.

Example:-65
lowest_signal_strength_rssi_dbm_7dinteger or nullread-onlyrequired

Lowest signal strength in RSSI dBm over the past 7 days. Null for WiFi EVSEs.

Example:-89
highest_signal_strength_rssi_dbm_7dinteger or nullread-onlyrequired

Highest signal strength in RSSI dBm over the past 7 days. Null for WiFi EVSEs.

Example:-57
connection_reliability_30dintegerread-onlyrequired

Connection reliability over the past 30 days, from 0 (fully offline) to 100 (fully online).

Example:97
ip_addressstring or nullread-onlyrequired

The IP address assigned to the EVSE's SIM. Null if no SIM data is available.

Example:"10.193.28.42"
iccidstring or nullread-onlyrequired

The ICCID of the EVSE's SIM card. Null if no SIM data is available.

Example:"8944110000001234567"
firmware_versionstring or nullread-onlyrequired

The current firmware version running on the EVSE. Null if not known.

Example:"1.2.3"
latest_status_log(string or null) or EVSEStatusLog (object)read-onlyrequired
One of:

An expandable reference to the most recent status log for this EVSE. URL by default, full object when ?expand=latest_status_log is used.

string or null (uri)read-only
Response
{
  "signal_strength_rssi_dbm": -65,
  "lowest_signal_strength_rssi_dbm_7d": -89,
  "highest_signal_strength_rssi_dbm_7d": -57,
  "connection_reliability_30d": 97,
  "ip_address": "10.193.28.42",
  "iccid": "8944110000001234567",
  "firmware_version": "1.2.3",
  "latest_status_log": "https://api.ev.energy/v2/evses/evse01HSH04KDEWF6Z4DB2J77J74K5/status_logs/2024-04-17T09:39:45.984584Z/"
}