This functionality allows integrators to locate existing Individuals in Donorfy based on multiple matching criteria. It helps avoid creating duplicate Constituent records by returning possible matches with confidence scores and matched-field explanations.
This endpoint uses the same duplicate-matching logic as Donorfy’s internal duplicate detection system.
How the Duplicate Matching Endpoint Works
The Duplicate Check endpoint performs an advanced match by:
Checking multiple permutations of the data you provide.
Returning a confidence score indicating how closely the data matches an existing Constituent.
Providing information about which fields matched (e.g., Address, Postal Code, Email).
The endpoint is accessed via a POST request:
https://data.donorfy.com/api/v1/<your api key>/constituents/DuplicateCheckPerson
You can pass in any combination of the following fields:
First Name
Last Name
National ID Number
Address Line 1
Postal Code
Phone Number
Mobile Number
Email Address
What the Endpoint Returns
The response includes a list of Individual Constituents that match your submitted data.
Each match contains:
Constituent ID
Basic Constituent Details – name, National ID, address, phone, mobile, email
Match Reason – which fields matched (e.g., Address, Postal Code)
Score – a number between 5 and 15 indicating match confidence
15 = highest confidence
5 = lowest confidence in the matched range
This allows your integration to determine whether to:
Link to an existing Constituent.
Create a new one if no strong matches are found.
⚠️Important:
The Donorfy API is a Professional only feature. Essential subscribers, please contact us to find out more about upgrading.