---
title: "fetchFaces(for:)"
framework: Media Intelligence
role: symbol
role_heading: Instance Method
platforms: [iOS 27.0+, iPadOS 27.0+, Mac Catalyst 27.0+, macOS 27.0+, tvOS 27.0+, visionOS 27.0+]
path: "mediaintelligence/facegroupanalyzer/fetchfaces(for:)"
---

# fetchFaces(for:)

Returns the faces belonging to the specified entities.

## Declaration

```swift
final func fetchFaces(for entityIDs: [FaceGroupAnalyzer.Entity.ID]) throws -> some AsyncSequence<(entityID: FaceGroupAnalyzer.Entity.ID, faces: Array<FaceGroupAnalyzer.Face>), any Error>

```

## Parameters

- `entityIDs`: The entity identifiers to look up.

## Mentioned in

Detecting and grouping faces in images

## Return Value

Return Value An async sequence of (entityID, faces) pairs.

## See Also

### Fetching and identifying faces

- [fetchFaces(_:)](mediaintelligence/facegroupanalyzer/fetchfaces(_:).md)
- [fetchFaces(in:)](mediaintelligence/facegroupanalyzer/fetchfaces(in:).md)
- [fetchAssetIDs(for:)](mediaintelligence/facegroupanalyzer/fetchassetids(for:).md)
- [identifyFaces(in:)](mediaintelligence/facegroupanalyzer/identifyfaces(in:).md)