What are match codes?
Match codes are flags that show how well the values of the input fields match the values fields in the output record.

How are match codes used?
They can appear in 2 places:
(1) Place match codes in the cfg_mc parameter to specify what kind of match is required for a record to be returned.
(2) Review the strength of a match by reviewing the Match Codes in the #RawMatchCodes field that is returned.

How should I use them with cfg_mc?
When using the cfg_mc parameter, use a "," to separate match codes with an "AND". Use a ";" to separate them with an "OR". For example, "cfg_mc=L,P;E" will return a record if both the last name and phone match or if only the email matches.

Basic Match Codes
Use the basic match codes below to require either an individual-level match or a household-level match for a record to be returned.

Match Code Scores
Match code scores give you an indication of how many match codes matched..

Advanced Match Codes
Use the advanced match codes below to allow for more flexible matches.

Match Code Examples

1. Query: https://api.datafinder.com/v2/qdf.php?k2=key&service={service}&d_first=John&d_last=Hoppily&cfg_mc=LF
   
   What's going on: Return a record if the first name and last name match the input first and last name. So in this case, return a record if the first name is "John" and the last name is "Hoppily"
2. Query: https://api.datafinder.com/v2/qdf.php?k2=key&service={service}&d_last=Hoppily&d_fulladdr=172 19th PL W&d_city=Seattle&d_state=WA&d_zip=98052&cfg_mc=L,ACSZ
   
   What's going on: Return a record if the last name, address, city, state, and zip, match the corresponding input fields. So in this case, return a record if the last name is "Hoppily" and entire address is "172 19th PL W, Seattle WA 98052"
3. Query: https://api.datafinder.com/v2/qdf.php?k2=key&service={service}&d_phone=4255552910&d_email=hoppily@domain.com&cfg_mc=E;P
   
   What's going on: Return a record if the phone number or email address match the corresponding input fields. So in this case, return a record if the phone number is "4255552910" or if the email is "hoppily@domain.com"