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.