<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.15.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 6.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Contacts",
  "identifier" : "/documentation/Contacts/CNContactStore/enumeratorForChangeHistoryFetchRequest:error:",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "Contacts"
    ],
    "preciseIdentifier" : "c:objc(cs)CNContactStore(im)enumeratorForChangeHistoryFetchRequest:error:"
  },
  "title" : "enumeratorForChangeHistoryFetchRequest:error:"
}
-->

# enumeratorForChangeHistoryFetchRequest:error:

Enumerates a change history fetch request.

```
- (CNFetchResult<NSEnumerator<CNChangeHistoryEvent *> *> *) enumeratorForChangeHistoryFetchRequest:(CNChangeHistoryFetchRequest *) request error:(NSError **) error;
```

## Parameters

`request`

A description of the events to fetch.

`error`

If the fetch fails, contains an <doc://com.apple.documentation/documentation/Foundation/NSError> object with more information.

## Return Value

An enumerator of the events matching the result, or `nil` if there was an error.

## Discussion

Executes the fetch request and returns an enumerator for the results. This can prevent all events from loading into memory at once. An error that occurs during enumeration may throw an exception.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)