GET apioauth/matrixv2/services/{serviceId}/evstatus

Get the electric system status for a service

Request Information

URI Parameters

Name	Description	Type	Additional information
serviceId	The service queried	unsigned integer	Required

Body Parameters

None.

Response Information

Resource Description

A EVStatusResponse

EvStatusResponse

Name	Description	Type	Additional information
ServiceId	The service id of the vehicle	unsigned integer	None.
VehicleRegistration	The vehicles registration	string	None.
ChargingState	The charging state	boolean	None.
BatteryChargeTime	How long the battery will take to charge in seconds	integer	None.
BatteryChargePercentage	The battery percentge	decimal number	None.
BatteryRange	The battery range in miles	integer	None.
Address	The address of the service	EvStatusAddress	None.
GpsData	The gps data	EvGpsData	None.
IoData	Input/Output data	EvIoData	None.

Response Formats

application/json, text/json

Sample:

{
  "ServiceId": 1,
  "VehicleRegistration": "sample string 2",
  "ChargingState": true,
  "BatteryChargeTime": 4,
  "BatteryChargePercentage": 5.1,
  "BatteryRange": 6,
  "Address": {
    "Street": "sample string 1",
    "Town": "sample string 2",
    "Country": "sample string 3",
    "PostCode": "sample string 4"
  },
  "GpsData": {
    "Latitude": 1.1,
    "Longitude": 2.1,
    "Speed": 3.1,
    "GpsTime": "2025-04-27T16:30:14.9833699+00:00"
  },
  "IoData": {
    "Ignition": true,
    "Input0": true,
    "Input1": true,
    "Input2": true,
    "Input3": true,
    "Output0": true,
    "Output1": true,
    "Output2": true,
    "Output3": true,
    "Voltage": 10.1
  }
}

application/xml, text/xml

Sample:

<EvStatusResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <ServiceId>1</ServiceId>
  <VehicleRegistration>sample string 2</VehicleRegistration>
  <ChargingState>true</ChargingState>
  <BatteryChargeTime>4</BatteryChargeTime>
  <BatteryChargePercentage>5.1</BatteryChargePercentage>
  <BatteryRange>6</BatteryRange>
  <Address>
    <Street>sample string 1</Street>
    <Town>sample string 2</Town>
    <Country>sample string 3</Country>
    <PostCode>sample string 4</PostCode>
  </Address>
  <GpsData>
    <Latitude>1.1</Latitude>
    <Longitude>2.1</Longitude>
    <Speed>3.1</Speed>
    <GpsTime>2025-04-27T16:30:14.9833699+00:00</GpsTime>
  </GpsData>
  <IoData>
    <Ignition>true</Ignition>
    <Input0>true</Input0>
    <Input1>true</Input1>
    <Input2>true</Input2>
    <Input3>true</Input3>
    <Output0>true</Output0>
    <Output1>true</Output1>
    <Output2>true</Output2>
    <Output3>true</Output3>
    <Voltage>10.1</Voltage>
  </IoData>
</EvStatusResponse>