<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: -"
  ],
  "documentType" : "symbol",
  "framework" : "EnergyKit",
  "identifier" : "/documentation/EnergyKit/ElectricVehicleChargingReason/ActiveReason",
  "metadataVersion" : "0.1.0",
  "role" : "Enumeration",
  "symbol" : {
    "kind" : "Enumeration",
    "modules" : [
      "EnergyKit"
    ],
    "preciseIdentifier" : "s:9EnergyKit29ElectricVehicleChargingReasonO06ActiveF0O"
  },
  "title" : "ElectricVehicleChargingReason.ActiveReason"
}
-->

# ElectricVehicleChargingReason.ActiveReason

Information about why a vehicle is actively charging.

```
enum ActiveReason
```

## Overview

Use these reasons with [`ElectricVehicleStatusEvent.Status.chargingActive(_:)`](/documentation/EnergyKit/ElectricVehicleStatusEvent/Status-swift.enum/chargingActive(_:)) to explain why charging starts or resumes.

## Topics

### Grid and rate optimization

[`case cleanerEnergyAvailable`](/documentation/EnergyKit/ElectricVehicleChargingReason/ActiveReason/cleanerEnergyAvailable)

A reason that indicates charging starts because cleaner energy becomes available on the grid.

[`case lowerElectricityRatesAvailable`](/documentation/EnergyKit/ElectricVehicleChargingReason/ActiveReason/lowerElectricityRatesAvailable)

A reason that indicates charging starts because lower electricity rates become available.

### User actions

[`case userInitiated`](/documentation/EnergyKit/ElectricVehicleChargingReason/ActiveReason/userInitiated)

A reason that indicates a person manually starts charging.

[`case userResumed`](/documentation/EnergyKit/ElectricVehicleChargingReason/ActiveReason/userResumed)

A reason that indicates a person manually resumes charging after pausing.

### Scheduled charging

[`case scheduledStart`](/documentation/EnergyKit/ElectricVehicleChargingReason/ActiveReason/scheduledStart)

A reason that indicates charging starts at a scheduled time.

[`case scheduledResume`](/documentation/EnergyKit/ElectricVehicleChargingReason/ActiveReason/scheduledResume)

A reason that indicates charging resumes at a scheduled time after pausing.

### System conditions resolved

[`case demandResponseEnded`](/documentation/EnergyKit/ElectricVehicleChargingReason/ActiveReason/demandResponseEnded)

A reason that indicates charging starts because a utility-demand response event ends.

[`case batteryThermalManagementCompleted`](/documentation/EnergyKit/ElectricVehicleChargingReason/ActiveReason/batteryThermalManagementCompleted)

A reason that indicates charging starts after battery thermal management completes.

[`case batteryHealthManagementCompleted`](/documentation/EnergyKit/ElectricVehicleChargingReason/ActiveReason/batteryHealthManagementCompleted)

A reason that indicates charging starts after battery health management completes.

[`case chargerFaultCleared`](/documentation/EnergyKit/ElectricVehicleChargingReason/ActiveReason/chargerFaultCleared)

A reason that indicates charging starts after a charger fault resolves.

[`case sufficientPowerRestored`](/documentation/EnergyKit/ElectricVehicleChargingReason/ActiveReason/sufficientPowerRestored)

A reason that indicates charging starts after sufficient power becomes available.

[`case loadBalancingCompleted`](/documentation/EnergyKit/ElectricVehicleChargingReason/ActiveReason/loadBalancingCompleted)

A reason that indicates charging starts after load-balancing completes.

### Unspecified reason

[`case unknown`](/documentation/EnergyKit/ElectricVehicleChargingReason/ActiveReason/unknown)

A reason that indicates charging starts for an unspecified or unavailable reason.

## Relationships

### Conforms To

[`Equatable`](/documentation/Swift/Equatable)

[`Hashable`](/documentation/Swift/Hashable)

[`Sendable`](/documentation/Swift/Sendable)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`Decodable`](/documentation/Swift/Decodable)

[`CaseIterable`](/documentation/Swift/CaseIterable)

[`Encodable`](/documentation/Swift/Encodable)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)