Match
Based upon the provided information, understand whether or not the information you have on an individual matches the FullContact Identity Graph and points to the same individual. This can help you identify risk on a form field or application. This endpoint will only accept one input per contact identifier (i.e. only one clear text email should be used as input alongside other multi-field inputs). This endpoint does not accept Record IDs, Person IDs and/or Partner IDs as input. If none of the inputs provided match to one another, FullContact will return true
for the input with the highest confidence found in our Graph.
curl -X POST \
https://api.fullcontact.com/v3/verify.match \
-H 'Authorization: Bearer {Your API Key}' \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"phone": "+17202227799",
"location": {
"addressLine1": "123 Main Street",
"addressLine2": "Unit 2",
"city": "Denver",
"region": "Colorado",
"regionCode": "CO",
"postalCode": "80203"
},
"name": {
"full": "Bart Lorang",
"given": "Bart",
"family": "Lorang"
}
}'
{
"city" : true,
"region" : true,
"country" : true,
"continent" : true,
"postalCode" : true,
"givenName" : true,
"familyName": true,
"phone" : false,
"email" : true
}
Match Response Properties | |
---|---|
city boolean | Indicates whether or not the inputted city matches to FullContact's Identity Graph and the other identifiers included in the request |
region boolean | Indicates whether or not the inputted region matches to FullContact's Identity Graph and the other identifiers included in the request |
country boolean | Indicates whether or not the country of the address inputted matches to FullContact's Identity Graph and the other identifiers included in the request |
continent boolean | Indicates whether or not the continent of the address inputted matches to FullContact's Identity Graph and the other identifiers included in the request |
postalCode boolean | Indicates whether or not the inputted postal (zip) code matches to FullContact's Identity Graph and the other identifiers included in the request |
familyName boolean | Indicates whether or not the inputted family name matches to FullContact's Identity Graph and the other identifiers included in the request |
givenName boolean | Indicates whether or not the inputted given name matches to FullContact's Identity Graph and the other identifiers included in the request |
phone boolean | Indicates whether or not the inputted phone number matches to FullContact's Identity Graph and the other identifiers included in the request |
maid boolean | Indicates whether or not the inputted MAID matches to FullContact's Identity Graph and the other identifiers included in the request |
email boolean | Indicates whether or not the inputted email matches to FullContact's Identity Graph and the other identifiers included in the request |
social boolean | Indicates whether or not the inputted social matches to FullContact's Identity Graph and the other identifiers included in the request |
nonId boolean | Indicates whether or not the inputted Non ID matches to FullContact's Identity Graph and the other identifiers included in the request |
Updated 4 days ago
Did this page help you?