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

# ElectricVehicleChargingReason.IdleReason

Information about why a vehicle remains idle when connected to a charger.

```
enum IdleReason
```

## Overview

Use these reasons with [`ElectricVehicleStatusEvent.Status.chargingIdle(_:)`](/documentation/EnergyKit/ElectricVehicleStatusEvent/Status-swift.enum/chargingIdle(_:)) to explain why charging hasn’t started or why it’s paused.

## Topics

### Charging targets reached

[`case targetStateOfChargeReached`](/documentation/EnergyKit/ElectricVehicleChargingReason/IdleReason/targetStateOfChargeReached)

A reason that indicates charging stops because the vehicle reaches its target state of charge.

[`case batteryFull`](/documentation/EnergyKit/ElectricVehicleChargingReason/IdleReason/batteryFull)

A reason that indicates charging stops because the battery is full.

[`case targetAlreadyReached`](/documentation/EnergyKit/ElectricVehicleChargingReason/IdleReason/targetAlreadyReached)

A reason that indicates charging doesn’t start because the vehicle is already charged to the target state.

### Scheduled conditions

[`case scheduledEnd`](/documentation/EnergyKit/ElectricVehicleChargingReason/IdleReason/scheduledEnd)

A reason that indicates charging stops at a scheduled end time.

[`case scheduledPause`](/documentation/EnergyKit/ElectricVehicleChargingReason/IdleReason/scheduledPause)

A reason that indicates charging pauses at a scheduled time.

### Grid and rate optimization

[`case waitingForCleanerEnergy`](/documentation/EnergyKit/ElectricVehicleChargingReason/IdleReason/waitingForCleanerEnergy)

A reason that indicates the vehicle waits for cleaner energy to become available on the grid.

[`case waitingForLowerElectricityRates`](/documentation/EnergyKit/ElectricVehicleChargingReason/IdleReason/waitingForLowerElectricityRates)

A reason that indicates the vehicle waits for lower electricity rates to become available.

### User actions

[`case userPaused`](/documentation/EnergyKit/ElectricVehicleChargingReason/IdleReason/userPaused)

A reason that indicates a person manually pauses charging.

[`case userStopped`](/documentation/EnergyKit/ElectricVehicleChargingReason/IdleReason/userStopped)

A reason that indicates a person manually stops charging.

### System conditions

[`case chargerFault`](/documentation/EnergyKit/ElectricVehicleChargingReason/IdleReason/chargerFault)

A reason that indicates charging stops due to a charger fault.

[`case demandResponseActive`](/documentation/EnergyKit/ElectricVehicleChargingReason/IdleReason/demandResponseActive)

A reason that indicates charging pauses due to an active utility-demand response event.

[`case batteryThermalManagement`](/documentation/EnergyKit/ElectricVehicleChargingReason/IdleReason/batteryThermalManagement)

A reason that indicates charging pauses for battery thermal management.

[`case batteryHealthManagement`](/documentation/EnergyKit/ElectricVehicleChargingReason/IdleReason/batteryHealthManagement)

A reason that indicates charging pauses for battery health management.

[`case insufficientPower`](/documentation/EnergyKit/ElectricVehicleChargingReason/IdleReason/insufficientPower)

A reason that indicates charging stops because insufficient power is available.

[`case loadBalancing`](/documentation/EnergyKit/ElectricVehicleChargingReason/IdleReason/loadBalancing)

A reason that indicates charging pauses due to load balancing with other electrical devices.

### Unspecified reason

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

A reason that indicates the vehicle is idle for an unspecified or unavailable reason.

## Relationships

### Conforms To

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

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

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

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

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

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

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

---

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)