Skip to content
/
VehicleLocationLog

ev.energy v2 API (2.0)

The official API for ev.energy, version 2.

Download OpenAPI description
ev.energy-API-v2.json
ev.energy-API-v2.yaml
Overview
URL
developers.ev.energy
ev.energy developers
developers@ev.energy
License
Proprietary
Languages
Servers
Mock server
https://developers.ev.energy/_mock/ev.energy-api-v2
Live API for both production and sandbox requests.
https://api.ev.energy/v2
Staging server for internal testing only.
https://api-staging.ev.energy/v2

Carbon

Endpoints for interacting with carbon intensity data.

Schemas
Operations

Charging Sessions

Endpoints related to records of charging.

Schemas
Operations
Webhooks

CSV

Endpoints that return CSV responses only and are not linkable to other endpoint data.

EVSEs

Endpoints for interacting with EVSEs.

Schemas
Operations

Notifications

Endpoints for communicating notifications.

Operations

Programs

Endpoints related to incentivised charging programs.

Operations

Rebates

Endpoints for interacting with rebates.

Schemas
Operations

Root

The root endpoint which lists all the top-level collections.

Operations

Schedules

Schema definitions for charging schedules.

Schemas

Sites

Endpoints for interacting with sites containing multiple EVSEs.

Operations

Solar

Endpoints for interacting with solar arrays and inverters.

Operations

Subscriptions

Endpoints for interacting with user subscriptions.

Operations

Support Tickets

Endpoints for interacting with customer support tickets.

Schemas
Operations

Tariffs

Endpoints related to energy suppliers and their tariffs.

Schemas
Operations

Users

Endpoints for interacting with users.

Schemas
Operations

Vehicles

Endpoints for interacting with vehicles.

Schemas

VehicleAPIErrorLog

Records an error that occurred when attempting to communicate with a vehicle's telematics API.

urlstring(uri)read-only
Example: "https://api.ev.energy/v2/vehicles/vhcl01HRFF3SEVSCRAV9B3CHVDFN0H/error_logs/2024-04-17T09:39:45.984584Z/"
logged_atstring(date-time)read-only

The date and time when this error was logged by the ev.energy system.

vehiclestring or Vehicle (object)
One of:
string(uri)
status_codeintegerread-only

The HTTP status code of the error response from the vehicle telematics API.

Example: 401
controllerstringread-only

The vehicle controller/integration that was being used when the error occurred.

Example: "ENODE"
error_codestringread-only

The error code received from the provider or determined by the ev.energy system.

Example: "AUTHENTICATION_ERROR"
error_typestringread-only

The error type received from the provider or determined by the ev.energy system.

Example: "VehicleAPIUnauthorized"
request_idstringread-only

The request ID that resulted in this error. Used for tracing and debugging.

Example: "56rst-z2jku-tty9t-0dn2f-qazow"
commandstringread-only

The command/method that was being executed when the error occurred.

Example: "START_CHARGE"
error_detailstringread-only

Detailed information about the error.

internal_command_idstring or null(uuid)read-only

Internal UUID to track the command dispatch. This can be used to correlate errors with commands.

Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
{
  "url": "https://api.ev.energy/v2/vehicles/vhcl01HRFF3SEVSCRAV9B3CHVDFN0H/error_logs/2024-04-17T09:39:45.984584Z/",
  "logged_at": "2019-08-24T14:15:22Z",
  "vehicle": "https://api.ev.energy/v2/vehicles/vhcl01HRFF3SEVSCRAV9B3CHVDFN0H",
  "status_code": 401,
  "controller": "ENODE",
  "error_code": "AUTHENTICATION_ERROR",
  "error_type": "VehicleAPIUnauthorized",
  "request_id": "56rst-z2jku-tty9t-0dn2f-qazow",
  "command": "START_CHARGE",
  "error_detail": "string",
  "internal_command_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

VehicleLocationLog

Records when location data was sampled for a vehicle. The actual location coordinates are not exposed through this resource.

urlstring(uri)read-only
Example: "https://api.ev.energy/v2/vehicles/vhcl01HRFF3SEVSCRAV9B3CHVDFN0H/location_logs/2024-04-17T09:39:45.984584Z/"
sampled_atstring(date-time)read-only

The date and time when the location data was sampled from the vehicle (supplied by the API).

logged_atstring(date-time)read-only

The server time the location event was received at.

vehiclestring or Vehicle (object)
One of:
string(uri)
at_homeboolean or nullread-only

Whether the vehicle was at the user's home location when this data was sampled. Will be null if the user has no home location configured.

{
  "url": "https://api.ev.energy/v2/vehicles/vhcl01HRFF3SEVSCRAV9B3CHVDFN0H/location_logs/2024-04-17T09:39:45.984584Z/",
  "sampled_at": "2019-08-24T14:15:22Z",
  "logged_at": "2019-08-24T14:15:22Z",
  "vehicle": "https://api.ev.energy/v2/vehicles/vhcl01HRFF3SEVSCRAV9B3CHVDFN0H",
  "at_home": true
}

VehicleCommandLog

Records a command that was sent to a vehicle.

urlstring(uri)read-only
Example: "https://api.ev.energy/v2/vehicles/vhcl01HRFF3SEVSCRAV9B3CHVDFN0H/command_logs/2024-04-17T09:39:45.984584Z/"
logged_atstring(date-time)read-only

The date and time when this command was logged by the ev.energy system.

vehiclestring or Vehicle (object)
One of:
string(uri)
commandstringread-only

The type of command that was sent to the vehicle.

Enum"START_CHARGE""STOP_CHARGE""WAKE_UP""SEND_SCHEDULE"
Example: "START_CHARGE"
external_command_idstring or nullread-only

External command ID from the vehicle provider.

Example: "ext-cmd-12345"
current_milliampsinteger or nullread-only

If a start/stop command was sent, this is the current level that was sent in milliamps.

Example: 32000
internal_command_idstring or null(uuid)read-only

Internal UUID to track this command dispatch. This links with device command logs and error logs.

Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
{
  "url": "https://api.ev.energy/v2/vehicles/vhcl01HRFF3SEVSCRAV9B3CHVDFN0H/command_logs/2024-04-17T09:39:45.984584Z/",
  "logged_at": "2019-08-24T14:15:22Z",
  "vehicle": "https://api.ev.energy/v2/vehicles/vhcl01HRFF3SEVSCRAV9B3CHVDFN0H",
  "command": "START_CHARGE",
  "external_command_id": "ext-cmd-12345",
  "current_milliamps": 32000,
  "internal_command_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Webhooks

Endpoints for configuring and managing webhooks.

Operations