List duplicate pairs
Returns pairs of records identified as potential duplicates by HubSpot’s default detection method. Records are scored by similarity across a standard set of properties. Use objectId to narrow results to pairs containing a specific record. To detect duplicates using custom matching criteria, see the custom duplicate rules endpoints.
By default, HubSpot identifies potential duplicates by comparing record property values for the following properties:
Contacts: First name, Last name, Email address, IP country, Phone number, Zip code, and Company name. Companies: Company domain name, Company name, Country/Region, Phone number, and Industry.
Supported products
Supported products
Query Parameters
A pagination cursor returned in a previous response. Pass this value to retrieve the next page of results.
The maximum number of pairs to return per page. Defaults to 25, maximum 200.
The unique identifier of the record to check for duplicates. Returns only pairs that contain this record.
The type of records to check for duplicates, such as contacts or companies. Required.
Response
successful operation
An array of PublicDuplicatePair objects, each representing a pair of records identified as potential duplicates.
The total number of duplicate pairs matching the request.
Represents the pagination information for navigating through a list of results in the API. It provides details on how to access the previous or next set of results.