Skip to main content

​
Electric Vehicle State

Electric vehicle state parameters provide real-time charging status, battery information, and consumption metrics. These fields are read-only and automatically updated from the manufacturer’s API.
State data refresh frequency depends on the manufacturer’s API. Tesla updates every 5-10 minutes when active, others may vary.

​
Charging Status

​
is_plugged_in
boolean
Indicates whether the charging cable is connected to the vehicle.Example: true
​
is_charging
boolean
Indicates whether charging is currently in progress.A vehicle can be plugged in but not actively charging (waiting for low-price period, charge limit reached, etc.).Example: true
​
is_fully_charged
boolean
Indicates that the target charge level has been reached and charging has stopped.Example: true
​
charge_rate_w
integer
Current charging rate in Watts.Returns 0 when not charging.Example: 11050
​
charge_time_remaining
integer
Estimated time to reach target charge level in seconds.Returns 0 when not charging or fully charged.Example: 6250 (approximately 1 hour 44 minutes)
​
charge_state_last_updated_at
datetime
Timestamp when the charge state was last updated from the manufacturer’s API.Use this to determine data freshness.Example: 2023-03-22T13:54:34.000Z

​
Battery Information

​
battery_level
integer
Current battery charge level in percent.Example: 90Range: 0-100
​
battery_capacity_kwh
integer
Total battery capacity in kilowatt-hours.Example: 80
​
driving_range
integer
Estimated remaining driving range in kilometers based on current battery level.May not be available for all vehicle models.Example: 390

​
Energy Consumption

​
consumption_last_day_kwh
float
Energy consumption for charging in the previous day in kWh.Example: 32.5
​
consumption_last_week_kwh
float
Energy consumption for charging in the previous week in kWh.Example: 120.1
​
consumption_last_month_kwh
float
Energy consumption for charging in the previous month in kWh.Example: 451.3
​
consumption_last_updated_utc
datetime
Timestamp when consumption data was last calculated.Example: 2023-03-22T13:54:34.000Z

​
Usage Examples

​
Get Vehicle State

curl -X GET \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/electric-vehicles/{device_id}' \
  -H 'Authorization: Bearer {auth_token}' \
  -H 'Accept: application/json'

​
Charging States Explained

Conditions: is_plugged_in: true, is_charging: true, charge_rate_w > 0Vehicle is actively drawing power and charging the battery.Typical Duration: 1-8 hours depending on battery size and charge rate

​
Best Practices

  • Poll vehicle state every 5-10 minutes when plugged in
  • Reduce polling to 15-30 minutes when not plugged in
  • Check charge_state_last_updated_at to avoid unnecessary calls
  • Show last update timestamp to users for transparency
  • Display driving_range prominently for user awareness
  • Consider range may vary based on driving conditions
  • Alert users when range drops below critical threshold (< 50 km)
  • Compare range to typical daily driving needs
  • Convert charge_time_remaining from seconds to hours:minutes for display
  • Show charge rate in kW (divide charge_rate_w by 1000)
  • Highlight when vehicle is waiting for optimal charging time
  • Provide context for why charging may be paused
  • Track consumption trends over time
  • Calculate estimated costs based on energy contract prices
  • Compare consumption to driving patterns
  • Identify opportunities for further optimization

EV Attributes

Writable parameters and configuration

Dashboard Integration

Building end-user dashboards

Energy Contracts

Energy pricing for optimization

Buildings

Building parameters reference