---
title: "fetchMomentLists(with:options:)"
framework: photos
role: symbol
role_heading: Type Method
path: "photos/phcollectionlist/fetchmomentlists(with:options:)"
---

# fetchMomentLists(with:options:)

Retrieves collection lists of the specified moment list type.

## Declaration

```swift
class func fetchMomentLists(with momentListSubtype: PHCollectionListSubtype, options: PHFetchOptions?) -> PHFetchResult<PHCollectionList>
```

## Parameters

- `momentListSubtype`: The type of moment list, either doc://com.apple.photokit/documentation/Photos/PHCollectionListSubtype/momentListCluster or doc://com.apple.photokit/documentation/Photos/PHCollectionListSubtype/momentListYear. 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 The Photos app automatically creates moments to group assets by time and location, and also creates moment lists to group related moments. Moment lists have two subtypes: a moment cluster groups a few related moments, and a moment year groups all moments in a calendar year.

## See Also

### Fetching Collection Lists

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