# CNChangeHistoryFetchRequest An object that specifies the criteria for fetching change history. ``` class CNChangeHistoryFetchRequest ``` ## Overview The system always returns changes to contacts. The system coalesces changes to remove redundant adds, updates, and deletes. Create and configure a fetch request, then call [`enumeratorForChangeHistoryFetchRequest:error:`](/documentation/Contacts/CNContactStore/enumeratorForChangeHistoryFetchRequest:error:) to process changes. ## Topics ### Configuring the fetch request [`additionalContactKeyDescriptors`](/documentation/Contacts/CNChangeHistoryFetchRequest/additionalContactKeyDescriptors) An array of contact property keys or key descriptors from contact objects to fetch in the returned contacts. [`excludedTransactionAuthors`](/documentation/Contacts/CNChangeHistoryFetchRequest/excludedTransactionAuthors) An array of strings that identify transaction authors to exclude from the fetch results. [`includeGroupChanges`](/documentation/Contacts/CNChangeHistoryFetchRequest/includeGroupChanges) A Boolean value that indicates whether the fetch should also return group changes. [`mutableObjects`](/documentation/Contacts/CNChangeHistoryFetchRequest/mutableObjects) A Boolean value that indicates whether the fetch should return mutable contacts and groups. [`shouldUnifyResults`](/documentation/Contacts/CNChangeHistoryFetchRequest/shouldUnifyResults) A Boolean value that indicates whether the fetch should return contact changes as unified contacts. [`startingToken`](/documentation/Contacts/CNChangeHistoryFetchRequest/startingToken) An opaque token that indicates a point in history in the user’s Contacts database. --- Copyright © 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)