Skip to main content

​
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

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

​
Device Model

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

​
Optimization Control

​
is_smart_optimization_active
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

​
charge_target_max
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 policies allow users to specify a required charge level by a specific deadline, ensuring the vehicle is ready for planned trips.
​
is_charge_policy_enabled
boolean
Flag indicating whether a charge policy is active.Example: trueWritable: Yes
​
charge_deadline_at
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
​
minimum_charge_limit
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
​
charge_policy_last_updated_at
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.
​
hems_min_export_to_start_w
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
​
hems_max_import_before_stopping_w
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
​
hems_min_production_to_start_w
integer
Minimum solar production in Watts required to start charging.Example: 3000Writable: Yes
​
hems_min_production_before_stopping_w
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
  }'

​
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
  }'

​
Best Practices

  • 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
  • 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

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,
})

Electric Vehicle State

Read-only state data and current readings

Setting Preferences

User workflow for configuring charging

Device Onboarding

Connecting electric vehicles