CustomerProfiles / Client / get_auto_merging_preview



Tests the auto-merging settings of your Identity Resolution Job without merging your data. It randomly selects a sample of matching groups from the existing matching results, and applies the automerging settings that you provided. You can then view the number of profiles in the sample, the number of matches, and the number of profiles identified to be merged. This enables you to evaluate the accuracy of the attributes in your matching list.

You can’t view which profiles are matched and would be merged.


We strongly recommend you use this API to do a dry run of the automerging process before running the Identity Resolution Job. Include at least two matching attributes. If your matching list includes too few attributes (such as only FirstName or only LastName), there may be a large number of matches. This increases the chances of erroneous merges.

See also: AWS API Documentation

Request Syntax

response = client.get_auto_merging_preview(
        'MatchingAttributesList': [
        'ConflictResolvingModel': 'RECENCY'|'SOURCE',
        'SourceName': 'string'
  • DomainName (string) –


    The unique name of the domain.

  • Consolidation (dict) –


    A list of matching attributes that represent matching criteria.

    • MatchingAttributesList (list) – [REQUIRED]

      A list of matching criteria.

      • (list) –

        • (string) –

  • ConflictResolution (dict) –


    How the auto-merging process should resolve conflicts between different profiles.

    • ConflictResolvingModel (string) – [REQUIRED]

      How the auto-merging process should resolve conflicts between different profiles.

      • RECENCY: Uses the data that was most recently updated.

      • SOURCE: Uses the data from a specific source. For example, if a company has been aquired or two departments have merged, data from the specified source is used. If two duplicate profiles are from the same source, then RECENCY is used again.

    • SourceName (string) –

      The ObjectType name that is used to resolve profile merging conflicts when choosing SOURCE as the ConflictResolvingModel.

  • MinAllowedConfidenceScoreForMerging (float) – Minimum confidence score required for profiles within a matching group to be merged during the auto-merge process.

Return type:



Response Syntax

    'DomainName': 'string',
    'NumberOfMatchesInSample': 123,
    'NumberOfProfilesInSample': 123,
    'NumberOfProfilesWillBeMerged': 123

Response Structure

  • (dict) –

    • DomainName (string) –

      The unique name of the domain.

    • NumberOfMatchesInSample (integer) –

      The number of match groups in the domain that have been reviewed in this preview dry run.

    • NumberOfProfilesInSample (integer) –

      The number of profiles found in this preview dry run.

    • NumberOfProfilesWillBeMerged (integer) –

      The number of profiles that would be merged if this wasn’t a preview dry run.


  • CustomerProfiles.Client.exceptions.BadRequestException

  • CustomerProfiles.Client.exceptions.ResourceNotFoundException

  • CustomerProfiles.Client.exceptions.AccessDeniedException

  • CustomerProfiles.Client.exceptions.ThrottlingException

  • CustomerProfiles.Client.exceptions.InternalServerException