Charging session

Auto API
Level 13
Last Updated
Level 13
Added In
Level 13
Identifier
0x00 0x6d

This page specifies the Auto API protocol for Vehicle Status. Head over to the REST API, iOS SDK, Android SDK or Node.js SDK code reference pages for platform specifics.

Business errors

id: 0x04
name: business_errors
name_cased: businessErrors
name_pretty: Business errors
name_singular: business_error
added: 13
type: string
multiple: true

Example

data_component: 506c6561736520636865636b20746865206368617267696e672073746174696f6e
value: Please check the charging station
description: Business error states 'Please check the charging station'
data_component: 5265706561742074686520706c75672d696e
value: Repeat the plug-in
description: Business error states 'Repeat the plug-in'

Calculated energy charged

id: 0x09
name: calculated_energy_charged
name_cased: calculatedEnergyCharged
name_pretty: Calculated energy charged
added: 13
type: unit.energy
size: 10
description: Calculated amount of energy charged during the session

Example

data_component: 0c04400c89374bc6a7f0
value:
  kilowatt_hours: 3.567
description: Calculated amount of energy charged was 3.567Kwh during the session

Charging cost

id: 0x0d
name: charging_cost
name_cased: chargingCost
name_pretty: Charging cost
added: 13
type: types.charging_cost
description: Charging cost information

Example

data_component: 0003455552400234eab76265223fe226809d495183400234eab7626522
values:
  currency: EUR
  calculated_charging_cost: 2.2758383109
  calculated_savings: 0.5672
  simulated_immediate_charging_cost: 2.2758383109
description: Charging costs are shown in 'EUR' with calculated costs of
  2.2758383109, calculated savings 0.5672 and simulated charging cost of
  2.2758383109

Displayed start state of charge

id: 0x03
name: displayed_start_state_of_charge
name_cased: displayedStartStateOfCharge
name_pretty: Displayed start state of charge
added: 13
type: types.percentage
description: Displayed state of charge at start to the driver

Example

data_component: 3fbeb851eb851eb8
value: 0.12
description: Displayed start state of charge is 12.0%

Displayed state of charge

id: 0x02
name: displayed_state_of_charge
name_cased: displayedStateOfCharge
name_pretty: Displayed state of charge
added: 13
type: types.percentage
description: Displayed state of charge to the driver

Example

data_component: 3fd28f5c28f5c28f
value: 0.29
description: Displayed state of charge is 29.0%

End time

id: 0x07
name: end_time
name_cased: endTime
name_pretty: End time
added: 13
type: timestamp
size: 8
description: End time of the charging session

Example

data_component: 000001781bc9fd3e
value: 2021-03-10T10:58:45.694Z
description: Charging session ended on 10. March 2021 at 10:58:45 CET

Energy charged

id: 0x0a
name: energy_charged
name_cased: energyCharged
name_pretty: Energy charged
added: 13
type: unit.energy
size: 10
description: Energy charged during the session

Example

data_component: 0c044002c28f5c28f5c3
value:
  kilowatt_hours: 2.345
description: Energy charged in the last session was 2.345Kwh

Location

id: 0x0e
name: location
name_cased: location
name_pretty: Location
added: 13
type: types.charging_location
description: Charging location address

Example

data_component: 00064265726c696e002b536b616c69747a65722053747261c39f652036382c203130393937204265726c696e2c204765726d616e790014536b616c69747a65722053747261c39f65203638
values:
  municipality: Berlin
  formatted_address: Skalitzer Straße 68, 10997 Berlin, Germany
  street_address: Skalitzer Straße 68
description: Charging location was 'Skalitzer Straße 68, 10997 Berlin, Germany'

Odometer

id: 0x0c
name: odometer
name_cased: odometer
name_pretty: Odometer
added: 13
type: unit.length
size: 10
description: The vehicle odometer value in a given units

Example

data_component: 120440a0040000000000
value:
  kilometers: 2050
description: Odometer is showing 2050.0km

Preconditioning state

id: 0x0b
name: preconditioning_state
name_cased: preconditioningState
name_pretty: Preconditioning state
added: 13
type: types.active_state
description: Preconditioning is active or not

Example

data_component: "01"
value: active
description: Preconditioning is active

Public charging points

id: 0x01
name: public_charging_points
name_cased: publicChargingPoints
name_pretty: Public charging points
added: 13
type: types.charging_point
multiple: true
description: Matching public charging points.

Example

data_component: 00064265726C696e000531303939370014536b616c69747a65722053747261c39f6520363800284869676820456e65726779204c6f7720507269636573204368617267696e672050726f7669646572
values:
  city: Berlin
  postal_code: "10997"
  street: Skalitzer Straße 68
  provider: High Energy Low Prices Charging Provider
description: Matching public charging point from 'High Energy Low Prices
  Charging Provider' is located at Skalitzer Straße 60, 10997 Berlin
data_component: 000754616c6c696e6e0005313031333000074861726a752036001f46726565205769666920616e64204368617267696e672050726f7669646572
values:
  city: Tallinn
  postal_code: "10130"
  street: Harju 6
  provider: Free Wifi and Charging Provider
description: Matching public charging point from 'Free Wifi and Charging
  Provider' is located at Harju 6, 10130 Tallinn

Start time

id: 0x06
name: start_time
name_cased: startTime
name_pretty: Start time
added: 13
type: timestamp
size: 8
description: Start time of the charging session

Example

data_component: 000001781bcbb94d
value: 2021-03-10T11:00:39.373Z
description: Charging session started on 10. March 2021 at 10:57:57 CET

Time zone

id: 0x05
name: time_zone
name_cased: timeZone
name_pretty: Time zone
added: 13
type: string
description: Time zone of the charging session

Example

data_component: 4575726f70652f4265726c696e
value: Europe/Berlin
description: Charging session`s time zone is Europe - Berlin

Total charging duration

id: 0x08
name: total_charging_duration
name_cased: totalChargingDuration
name_pretty: Total charging duration
added: 13
type: unit.duration
size: 10
description: Total time charging was active during the session

Example

data_component: 070040c11e8000000000
value:
  seconds: 8765
description: Total time the charging was active was 8765.0s in the session