---
title: "fetchCollectionLists(with:subtype:options:)"
framework: photos
role: symbol
role_heading: Type Method
path: "photos/phcollectionlist/fetchcollectionlists(with:subtype:options:)"
---

# fetchCollectionLists(with:subtype:options:)

Retrieves collection lists of the specified type.

## Declaration

```swift
class func fetchCollectionLists(with collectionListType: PHCollectionListType, subtype: PHCollectionListSubtype, options: PHFetchOptions?) -> PHFetchResult<PHCollectionList>
```

## Parameters

- `collectionListType`: A type of collection list. See doc://com.apple.photokit/documentation/Photos/PHCollectionListType.
- `subtype`: A subtype of collection list. See doc://com.apple.photokit/documentation/Photos/PHCollectionListSubtype.
- `options`: Options that specify a filter predicate and sort order for the fetched collection lists, 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 PHCollectionList objects, or an empty fetch result if no objects match the request.

## Discussion

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

## See Also

### Fetching Collection Lists

- [fetchCollectionListsContaining(_:options:)](photos/phcollectionlist/fetchcollectionlistscontaining(_:options:).md)
- [fetchCollectionLists(withLocalIdentifiers:options:)](photos/phcollectionlist/fetchcollectionlists(withlocalidentifiers:options:).md)
- [fetchMomentLists(with:containingMoment:options:)](photos/phcollectionlist/fetchmomentlists(with:containingmoment:options:).md)
- [fetchMomentLists(with:options:)](photos/phcollectionlist/fetchmomentlists(with:options:).md)