# EnergyKit Provide grid forecasts and energy insights to help people optimize their electricity usage. ## Overview EnergyKit provides grid forecasts and energy insights to help people view their energy consumption patterns and choose when to use electricity at home. The framework delivers personalized forecasts for a home based on grid cleanliness and electricity rates, when available, enabling apps to optimize device operation for environmental impact and cost. Use EnergyKit to build apps that manage home device electricity usage and support the transition to a cleaner electricity grid. You can use the framework for residential, metered locations such as smart thermostats (HVAC), and for electric vehicle charging.  Using EnergyKit, your app can: - Receive grid forecasts that identify when cleaner electricity is available and when electricity rates are lower, when rate plan information is available. - Submit electrical load events that track device energy consumption during operation and provide data for the Home app. - Request insights about a customer’s historical electricity usage correlated with grid cleanliness and electricity rate periods. - Display rich activity logs and analytics in the Home app without building custom statistics or graphing UI. ## Receive energy guidance and submit energy use The framework provides two complementary workflows: - The ``doc://com.apple.energykit/documentation/EnergyKit/ElectricityGuidance`` structure identifies optimal times for electricity usage based on grid cleanliness and utility rates. Use this guidance to optimize when your managed devices consume electricity. - Submit ``doc://com.apple.energykit/documentation/EnergyKit/ElectricVehicleLoadEvent`` and ``doc://com.apple.energykit/documentation/EnergyKit/ElectricHVACLoadEvent`` instances that track energy consumption during device operation. Optionally submit ``doc://com.apple.energykit/documentation/EnergyKit/ElectricVehicleStatusEvent`` instances that explain charging behavior and support informative activity logs in the Home app. > Important: Energy guidance is only available in the contiguous United States. > > To use EnergyKit, the system requires your app to have the entitlement with a value of `true`. ## Display energy data in the Home app When you adopt the , the Home app displays your electrical load events in a unified energy experience. The Home app shows: - Historical charts with up to five years of energy data - Activity logs that explain device behavior with timestamps and reasons - Monthly trend notifications about energy usage patterns - Whole-home energy overlays when people connect their utility account This integration eliminates the need to build custom analytics UI, while providing a consistent experience across all energy devices in a person’s home. ## Topics ### Essentials [Optimizing home electricity usage](/documentation/EnergyKit/optimizing-home-electricity-usage) Shift electric vehicle charging schedules to times when the grid is cleaner and potentially less expensive. [Providing charging history for electric vehicles](/documentation/EnergyKit/providing-informative-charging-history-for-electric-vehicles) Track energy consumption and provide people detailed insights into the charging of their electric vehicle. ### Electricity guidance Request forecasts that identify when to shift or reduce electricity usage based on grid cleanliness and utility rates. [`ElectricityGuidance`](/documentation/EnergyKit/ElectricityGuidance) A data model that provides guidance on when electricity is cleaner and less expensive. ### Electric vehicle events Submit load events that track energy consumption and status events that explain charging behavior. [`ElectricVehicleLoadEvent`](/documentation/EnergyKit/ElectricVehicleLoadEvent) A measurement of the electricity consumed or generated by an electric vehicle while connected to a charger. [`ElectricVehicleStatusEvent`](/documentation/EnergyKit/ElectricVehicleStatusEvent) An event that represents the status of an electric vehicle while connected to a charger. [`ElectricVehicleChargingReason`](/documentation/EnergyKit/ElectricVehicleChargingReason) Information about a charging-state transition in an electric vehicle status event. ### HVAC events Submit load events that track heating and cooling energy consumption. [`ElectricHVACLoadEvent`](/documentation/EnergyKit/ElectricHVACLoadEvent) A measurement of the electricity consumed by an HVAC system. ### Device identification Identify electrical load devices with type safety and runtime validation. [`ElectricalLoadDevice`](/documentation/EnergyKit/ElectricalLoadDevice) A type that identifies an electrical load device for event submission. [`ElectricalLoadEventProtocol`](/documentation/EnergyKit/ElectricalLoadEventProtocol) A type that can represent an electrical load event. ### Energy venues Submit electrical load events for physical locations. [`EnergyVenue`](/documentation/EnergyKit/EnergyVenue) A physical site that uses or produces electricity at that location. ### Electricity insights Request historical insights about device energy consumption with cleanliness and cost attribution. [`ElectricityInsightService`](/documentation/EnergyKit/ElectricityInsightService) A service for retrieving insights about electricity consumption. [`ElectricityInsightQuery`](/documentation/EnergyKit/ElectricityInsightQuery) A structure describing a query that you use to obtain environmental impact information in the form of electricity insight records. [`ElectricityInsightRecord`](/documentation/EnergyKit/ElectricityInsightRecord) A structure that provides environmental impact and cost insights for electricity usage over a specific time period. [`ElectricityInsightMeasure`](/documentation/EnergyKit/ElectricityInsightMeasure) A protocol for types that can measure electricity usage data. ### Supporting types [`ElectricityFlowDirection`](/documentation/EnergyKit/ElectricityFlowDirection) Information about which direction the electricity moves. [`EnergyKitError`](/documentation/EnergyKit/EnergyKitError) A specialized error that provides localized messages describing the error and why it occurred. --- Copyright © 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)