Electric Vehicle Attributes

Electric vehicle attributes are writable parameters that control charging behavior, optimization settings, and user preferences for charge limits and schedules.

Required Parameters

string (UUID)

required

User ID that owns this electric vehicle.Example: 016b78a7-0c7c-4241-a277-015c3ad3cb90Writable: No (set at device creation)

Device Model

object

The device model assigned to this electric vehicle. Set during onboarding.Writable: No (set at device creation)

Show device_model fields

string

Manufacturer name. Example: Tesla

string

Model name. Example: Model 3

integer

Model year, if available. Example: 2023

object

Show device_type fields

string

Machine-readable device type identifier. Example: ev

string

Human-readable device type label. Example: Electric Vehicle

Optimization Control

boolean

Flag indicating whether Podero’s smart optimization is actively controlling charging.Set to false to pause optimization without disconnecting the vehicle.Example: trueWritable: Yes

Charge Limits

integer

OEM-detected hard cap on the battery charge level in percent. Set automatically by the system based on the vehicle’s detected charge limit — null means no cap has been detected yet.Example: 80Range: 0-100Writable: No (system-managed)

Charge Policy

Charge Policy Overview

Charge policies allow users to specify a required charge level by a specific deadline, ensuring the vehicle is ready for planned trips.

boolean

Flag indicating whether a charge policy is active.Example: trueWritable: Yes

time

Time of day by which the specified charge level must be reached (HH:MM format, 24h).Used in combination with minimum_charge_limit to ensure the vehicle is ready by a specific time each day.Example: 07:00Writable: Yes

integer

Minimum charge level in percent that must be reached by the deadline specified in charge_deadline_at.This overrides normal charging optimization to prioritize meeting the deadline.Example: 75Range: 0-100Writable: Yes

datetime

Timestamp when the charge policy was last updated. Read-only, automatically managed.Example: 2023-03-22T13:54:34.000ZWritable: No (system-managed)

HEMS Configuration

When a user also has a solar inverter, the EV can be set to charge reactively based on solar production and grid export signals. The following thresholds control when charging starts and stops.

integer

Minimum grid export in Watts required to start charging. Charging begins when the household is exporting at least this much power to the grid.Example: 2000Writable: Yes

integer

Maximum grid import in Watts before charging stops. If the household starts importing more than this from the grid, EV charging is paused.Example: 4000Writable: Yes

integer

Minimum solar production in Watts required to start charging.Example: 3000Writable: Yes

integer

Minimum solar production in Watts required to keep charging. If production drops below this, charging stops.Example: 2000Writable: Yes

Usage Examples

Configure Daily Charging

curl -X PUT \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/electric-vehicles/{device_id}' \
  -H 'Authorization: Bearer {auth_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "is_smart_optimization_active": true,
    "is_charge_policy_enabled": true,
    "charge_deadline_at": "07:00",
    "minimum_charge_limit": 80
  }'

response = requests.put(
    f'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/electric-vehicles/{device_id}',
    headers={
        'Authorization': f'Bearer {auth_token}',
        'Content-Type': 'application/json'
    },
    json={
        'is_smart_optimization_active': True,
        'is_charge_policy_enabled': True,
        'charge_deadline_at': '07:00',
        'minimum_charge_limit': 80
    }
)

Set Charge Deadline for Trip

curl -X PUT \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/electric-vehicles/{device_id}' \
  -H 'Authorization: Bearer {auth_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "is_charge_policy_enabled": true,
    "charge_deadline_at": "07:00",
    "minimum_charge_limit": 90
  }'

response = requests.put(
    f'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/electric-vehicles/{device_id}',
    headers={
        'Authorization': f'Bearer {auth_token}',
        'Content-Type': 'application/json'
    },
    json={
        'is_charge_policy_enabled': True,
        'charge_deadline_at': '07:00',
        'minimum_charge_limit': 90
    }
)

Best Practices

Charge Policies

Use charge policies for planned trips requiring specific charge levels
Set deadlines with enough buffer time for charging completion
Clear charge policies after the deadline passes
Monitor charge_policy_last_updated_at to track changes

Optimization

Keep is_smart_optimization_active enabled for cost savings
Optimization works best with spot hourly energy pricing
Vehicle will always respect deadlines and minimum charge requirements

Charge Policy Scenarios

Daily Commute
Weekend Trip
Flexible Charging

Scenario: User needs 70% charge by 7 AM every weekday

update_vehicle({
    'is_charge_policy_enabled': True,
    'charge_deadline_at': '07:00',
    'minimum_charge_limit': 70,
})

Scenario: User needs full charge for long trip on Saturday morning

update_vehicle({
    'is_charge_policy_enabled': True,
    'charge_deadline_at': '08:00',
    'minimum_charge_limit': 100,
})

# Clear after trip
# ... after trip completes ...
update_vehicle({
    'is_charge_policy_enabled': False,
})

Scenario: No specific deadline, optimize for lowest cost

# Disable policy, rely on optimization
update_vehicle({
    'is_charge_policy_enabled': False,
    'is_smart_optimization_active': True,
})

Electric Vehicle State

Read-only state data and current readings

Setting Preferences

User workflow for configuring charging

Device Onboarding

Connecting electric vehicles

Overview

Getting Started

End-User Workflows

Back-Office Workflows

Notifications

API Reference

Heat Pumps

Electric Vehicles

Solar Inverters

Electric Vehicle Attributes

Electric Vehicle Attributes

Required Parameters

Device Model

Optimization Control

Charge Limits

Charge Policy

HEMS Configuration

Usage Examples

Configure Daily Charging

Set Charge Deadline for Trip

Best Practices

Charge Policy Scenarios

Electric Vehicle State

Setting Preferences

Device Onboarding

​Electric Vehicle Attributes

​Required Parameters

​Device Model

​Optimization Control

​Charge Limits

​Charge Policy

​HEMS Configuration

​Usage Examples

​Configure Daily Charging

​Set Charge Deadline for Trip

​Best Practices

​Charge Policy Scenarios

Electric Vehicle State

Setting Preferences

Device Onboarding

Electric Vehicle Attributes

Required Parameters

Device Model

Optimization Control

Charge Limits

Charge Policy

HEMS Configuration

Usage Examples

Configure Daily Charging

Set Charge Deadline for Trip

Best Practices

Charge Policy Scenarios