Skip to content
/
Retrieve an EVSE firmware...

Retrieve an EVSE firmware version

Request

Retrieve a single EVSE firmware version by ID.

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

The ID of the specific EVSE firmware version.

Example:evsf01HSH04KDEWF6Z4DB2J77J74K5
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/evse_firmware_versions/evsf01HSH04KDEWF6Z4DB2J77J74K5 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'EvEnergy-Version: 2'

Responses

Returns an EVSE firmware version.

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
idstringevsf[A-Z\d]{26}read-onlyrequired
Example:"evsf01HSH04KDEWF6Z4DB2J77J74K5"
urlstring, (uri)read-onlyrequired
Example:"https://api.ev.energy/v2/evse_firmware_versions/evsf01HSH04KDEWF6Z4DB2J77J74K5/"
versionstringread-onlyrequired

The internal firmware version identifier.

Example:"1.2.3"
public_versionstring or nullread-onlyrequired

The publicly displayed version label, if different from the internal version.

Example:"1.2"
change_logstring or nullread-onlyrequired

A summary of the changes in this firmware release.

Example:"Bug fixes and stability improvements"
support_urlstring or null, (uri)read-onlyrequired

A link to documentation describing this firmware version.

Example:"https://example.com/firmware/1.2"
Response
{
  "id": "evsf01HSH04KDEWF6Z4DB2J77J74K5",
  "url": "https://api.ev.energy/v2/evse_firmware_versions/evsf01HSH04KDEWF6Z4DB2J77J74K5/",
  "version": "1.2.3",
  "public_version": "1.2",
  "change_log": "Bug fixes and stability improvements",
  "support_url": "https://example.com/firmware/1.2"
}