Read Person Merge
Read the current state of the potential merge by performing a merge analysis. The filter request parameter may be specified indicating which categories of information need to be analyzed. If no filter is specified then all categories will be used. The valid filter categories are listed below.
| Filter | Description |
|---|---|
| CoupleRelationships | Analyze couple relationships |
| NonVitalConclusions | Analyze non-vital conclusions |
| ParentChildRelationshipsAsChild | Analyze parent-child relationships as child |
| ParentChildRelationshipsAsParent | Analyze parent child relationships as parent |
| SourceReferences | Analyze source references |
| VitalConclusions | Analyze vital conclusions |
The following results will be returned in the merge analysis.
| Category | Description |
|---|---|
| survivorResources | A list of resources that are unique to the survivor person or have same value in both survivor and duplicate persons |
| duplicateResources | A list of resources on the duplicate person that do not exist on the survivor person |
| conflictingResources | A list of conflicts where the resource exists in the survivor and the duplicate persons and have different values |
| survivor | A person resource retained in the merge process |
| duplicate | The person resource deleted in the merge process |
Path parameters
The id of the survivor. Can be a person from the main FamilySearch tree or from a user tree. To find an example person ID, see <a href="/reference/searchtreepersons" target="_blank">Search Tree Persons</a>.
The id of the duplicate. Can be a person from the main FamilySearch tree or from a user tree. To find an example person ID, see <a href="/reference/searchtreepersons" target="_blank">Search Tree Persons</a>.
Query parameters
The filter to apply to the merge analysis. One of "CoupleRelationships", "NonVitalConclusions", "ParentChildRelationshipsAsChild", "ParentChildRelationshipsAsParent", "SourceReferences", "VitalConclusions".
Headers
Specifies the media type(s) that the client is willing to accept in the response.
Response
The merge analysis. See <a href="https://developers.familysearch.org/main/docs/json-schema#mergeanalysis" target="_blank">MergeAnalysis Schema (JSON)</a>