---
title: "energyInsights(forDeviceID:using:atVenue:)"
framework: energykit
role: symbol
role_heading: Instance Method
path: "energykit/electricityinsightservice/energyinsights(fordeviceid:using:atvenue:)"
---

# energyInsights(forDeviceID:using:atVenue:)

Returns data that provides insight into electrical usage for a given device.

## Declaration

```swift
final func energyInsights(forDeviceID deviceID: String, using query: ElectricityInsightQuery, atVenue energyVenueID: UUID) async throws -> AsyncStream<ElectricityInsightRecord<Measurement<UnitEnergy>>>
```

## Parameters

- `deviceID`: The device identifier to return doc://com.apple.energykit/documentation/EnergyKit/ElectricityInsightRecords for.
- `query`: The doc://com.apple.energykit/documentation/EnergyKit/ElectricityInsightQuery to specify the results.
- `energyVenueID`: The doc://com.apple.energykit/documentation/EnergyKit/EnergyVenue identifier to return doc://com.apple.energykit/documentation/EnergyKit/ElectricityInsightRecords for.

## Return Value

Return Value An AsyncStream of ElectricityInsightRecords containing UnitEnergy values for a given device.

## Discussion

Discussion The system throws EnergyKitError.venueUnavailable if a person provides an invalid EnergyVenue identifier. If another request is in progress, the system throwsEnergyKitError.inProgress.

## See Also

### Getting device insights

- [runtimeInsights(forDeviceID:using:atVenue:)](energykit/electricityinsightservice/runtimeinsights(fordeviceid:using:atvenue:).md)