Skip to content

Schedules

The Schedules endpoint returns the charging schedules associated with a charging sub-session. Schedules represent the planned charging intervals that the scheduler has calculated, including when charging should occur and at what current.

For a comprehensive explanation of how schedules are calculated, see The Scheduler.

Understanding Schedule Data

Schedule Revisions

The scheduler recalculates schedules throughout a charging session as conditions change. By default, the endpoint returns only the most recently created schedule for each time period (only_most_recently_created=true).

To see the full history of schedule revisions (useful for debugging or analysis), set only_most_recently_created=false. This will return all schedules, ordered by started_at and then by created_at descending.

Interpreting current_milliamps

  • 0 means the vehicle is scheduled to not charge during this interval
  • A positive value (e.g., 7400, 32000) indicates charging at that current
  • The actual charge rate may be lower if limited by the vehicle or EVSE capabilities