---
title: "fetchAssetCollections(with:subtype:options:)"
framework: photos
role: symbol
role_heading: Type Method
path: "photos/phassetcollection/fetchassetcollections(with:subtype:options:)"
---

# fetchAssetCollections(with:subtype:options:)

Retrieves asset collections of the specified type and subtype.

## Declaration

```swift
class func fetchAssetCollections(with type: PHAssetCollectionType, subtype: PHAssetCollectionSubtype, options: PHFetchOptions?) -> PHFetchResult<PHAssetCollection>
```

## Parameters

- `type`: A type of asset collection, such as an album or a moment. See doc://com.apple.photokit/documentation/Photos/PHAssetCollectionType.
- `subtype`: A subtype of asset collection. See doc://com.apple.photokit/documentation/Photos/PHAssetCollectionSubtype.
- `options`: Options that specify a filter predicate and sort order for the fetched asset collections, or nil to use default options. For details, see doc://com.apple.photokit/documentation/Photos/PHFetchOptions.

## Return Value

Return Value A fetch result that contains the requested PHAssetCollection objects, or an empty fetch result if no objects match the request.

## Discussion

Discussion By default, the returned PHFetchResult object contains all asset collections with the specified type and subtype. To retrieve a more specific set of asset collections, provide a PHFetchOptions object containing a filter predicate.

## See Also

### Fetching Asset Collections

- [fetchAssetCollections(withLocalIdentifiers:options:)](photos/phassetcollection/fetchassetcollections(withlocalidentifiers:options:).md)
- [fetchAssetCollectionsContaining(_:with:options:)](photos/phassetcollection/fetchassetcollectionscontaining(_:with:options:).md)
- [fetchAssetCollections(withALAssetGroupURLs:options:)](photos/phassetcollection/fetchassetcollections(withalassetgroupurls:options:).md)
- [fetchMoments(inMomentList:options:)](photos/phassetcollection/fetchmoments(inmomentlist:options:).md)
- [fetchMoments(with:)](photos/phassetcollection/fetchmoments(with:).md)