Skip to main content

Get composite charging schedule

POST 
/chargers/:id/actions/get-composite-schedule

Sends an OCPP GetCompositeSchedule command requesting the charger to calculate and return the effective charging schedule resulting from all active profiles.

Use Cases:

  • Verify charging profile configuration is correct
  • Debug load balancing and smart charging behavior
  • Predict charging power over time for cost estimates
  • Validate that site power limits are enforced
  • Troubleshoot unexpected charging speed or interruptions

What Is Composite Schedule: The composite schedule is the combined result of all active charging profiles, calculated by the charger using OCPP stack level priorities:

  • Multiple profiles with different purposes and priorities
  • Merged into single time-based power limit schedule
  • Represents actual power limits charger will enforce

Schedule Calculation:

  1. Charger combines all active profiles by stack level priority
  2. Lower stack levels override higher stack levels
  3. ChargePointMaxProfile enforces site-wide limits
  4. TxProfile customizes individual session behavior
  5. Result: time-based power schedule for requested duration

Request Parameters:

  • Connector ID: Which connector to get schedule for
  • Duration: How many seconds into future to calculate
  • Charging Rate Unit (optional): Return in watts (W) or amps (A)

Best Practices:

  • Request schedule after setting or clearing profiles to verify behavior
  • Use to validate load balancing calculations
  • Monitor schedule during active sessions to debug power issues
  • Check schedule matches expected profile configuration
info

Composite schedule shows the ACTUAL power limits the charger will enforce, calculated from all active profiles. Use this to verify your smart charging configuration.

tip

Request composite schedule after SetChargingProfile or ClearChargingProfile to confirm the changes took effect as expected.

Request​

Responses​

Standard success response for actions