GET apioauth/matrixv2/groups/{groupId}/evstatus

Get the electric system status for all services in a group

Request Information

URI Parameters

NameDescriptionTypeAdditional information
groupId

unsigned integer

Required

Body Parameters

None.

Response Information

Resource Description

A collection of EVStatusResponse

Collection of EvStatusResponse
NameDescriptionTypeAdditional 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:00:47.4437531+00:00"
    },
    "IoData": {
      "Ignition": true,
      "Input0": true,
      "Input1": true,
      "Input2": true,
      "Input3": true,
      "Output0": true,
      "Output1": true,
      "Output2": true,
      "Output3": true,
      "Voltage": 10.1
    }
  },
  {
    "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:00:47.4437531+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:
<ArrayOfEvStatusResponse xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <EvStatusResponse>
    <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:00:47.4437531+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>
  <EvStatusResponse>
    <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:00:47.4437531+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>
</ArrayOfEvStatusResponse>