D&B Direct+ Identity Resolution (IDR) uses input criteria to find the best candidates in its extensive
database of entities. It uses proprietary algorithms to identify the best matches and returns those matches with
detailed information about what criteria was used to find the match.
Identity Resolution API, Batch Match, and High-Volume Match perform all 3 of these steps.
Cleansing, Parsing and Standardization maximizes the impact of the inquiry in identifying candidates.
Cleanse
Parse
Standardize
Request | Cleanse | Parse | Standardize | |
---|---|---|---|---|
Name | Alpha Plastics of L.V. | Alpha Plastics LV | ALPHA PLASTIC LV |
|
Address | 123 N ELM STR, BETHLHM PA 18025 | Street number: 123 Street name: Elm St. City: Bethlehem State: PA Zip: 18025 Zip Ext: 1234 Latitude:40.837470 Longitude:-73.910533 Geocode: 000 |
D&B Direct+ stores reference files containing multiple indicia such as name, address, telephone and others allowing multiple match points for the same entity.
For example:
Inquiry | D&B Reference File | |
---|---|---|
Joe's Pizza 7 Carmine St Manhattan, NY 10014 |
- Joe's Pizza = Trade style for Golden Pizza Inc - Vanity City name replaced by primary city (New York) |
Golden Pizza Inc 7 Carmine St New York, NY 10014-4441 |
MatchGrade String (MGS)
Evaluation of each inquiry data element based on similarity between the cleansed
inquiry data and Reference File candidate.
Confidence Code (CC)
Qualitative evaluation indicating the overall match quality for each inquiry.
Match Data Profile (MDP)
Information on the type of data used to make the match.
MatchGrade Strings provide qualitative assessments between inquiry and reference components. These strings provide insights on quality and rationale for use case specific acceptance criteria.
Each evaluated component receives one of the following grades:
Grade | Definition | Example |
---|---|---|
A | Considered the same | Alpha Plastics vs. Alpha Plastics Co. |
B | Some similarity | Alpha Plastics vs. Alpha Plastics & Metal |
F | Considered different | Alpha Plastics vs. Alpha Plumbing |
Z | Missing information; cannot make conclusion | Inquiry and/or reference data are blank |
The components are:
Confidence codes are based on the detailed MatchGrade Strings™; over 4 million string combinations are mapped to 10 Confidence Codes, allowing for broad categorization of matched records. The higher the number, the higher the confidence that it is an accurate match.
The algorithms that are used to by Identity Resolution assign a value between 1 and 10 representing the degree of certainty that a candidate is a suitable match based on the criteria provided. Each Identity Resolution request returns entities whose Confidence Code value (when rounded to the nearest whole number) is equal to or exceeds the threshold value.
Match Data Profile (MDP) codes detail the type of information contained in the reference record.
Match Data Profile (MDP) Codes indicate if and how each component type was matched in the returned candidate.
The Match Data Profile appears in the API response as follows:
'matchDataProfile': '0100000098989800000098009898',
'matchDataProfileComponentsCount': 14,
'matchDataProfileComponents': [
{
'componentType': 'Name',
'componentValue': '01'
… }}
With an entry for each Component Type. Below is an example for Business Name. A reference for all codes can be found under Appendix: Match Data Profile (MDP) Codes Reference
Customer Input Name | D&B Name Returned | MDP Code for Business Name | Matched To |
---|---|---|---|
Smith Bros Clothiers | Smiths Bros Clothiers, Inc | 00 | Business Name |
Smith Bros Cloth Inc | Smiths Bros Clothiers, Inc | 01 | Registered Name |
Smiths' Clothes | Smiths Bros Clothiers, Inc | 02 | Tradestyle |
Edward Smith | Smiths Bros Clothiers, Inc | 03 | CEO Name |
John Smith | Smiths Bros Clothiers, Inc | 04 | Additional Executive |
SBC LLC | Smiths Bros Clothiers, Inc | 10 | Registered Acronym |
Gorman & Sons | Gorman Brothers Acquisition | 05 | Former Business Name |
Thomas Johnson | Gorman Brothers Acquisition | 07 | Former CEO Name |
The nameMatchScore allows you to further segment quality when a Business Name is matched, so, for example, if have lots of Bs for Name, you can see which are better than others using the nameMatchScore.
nameMatchScore returns a number from 0 to 100; the higher the number, the better the match.
Depending on the criteria provided, the system performs a specific match type.
This is identified in the response; for example:
"matchDataCriteria": "Name and Address Lookup",
The D&B Identity Resolution engine inspects the Request Parameters provided and determines how to yield the best results. The following list explains the order in which the parameters will be evaluated:
Precedence | Lookup Type | Notes |
---|---|---|
1 | D-U-N-S | D-U-N-S Number® |
2 | Registration | A Registration lookup is triggered first when the request includes the following, If resulted candidates have low confidence code then match will be performed based on name or address provided and does not meet any of the above rules: - Registration Number - Registration Number Type - Name - Street - Locality - Region - Country |
3 | Name & Address | Name & Address Lookup is triggered when the request includes the following and does not meet any of the
above rules: - Name - Street - Locality - Region - Country |
4 | Telephone Number | A Telephone Number lookup is triggered when the request includes the following and does not meet any of the
above rules: - Telephone Number - Country |
5 | Domain/Email | A Domain lookup is triggered when the request includes the following and does not meet any of the above
rules: - URL (or) Email Note:
|
D&B Direct+ Identity Resolution provides a single API to request matches in all supported languages.
Asian language is only supported for Name and Address lookup.
The system determines the language to use as follows:
If inLanguage is set to "auto":
This code indicates where the name request value was found.
Code | Match To | Notes |
---|---|---|
00 | Primary Name. | |
01 | Registered Name. | Not applicable for US and Canada |
02 | Trade Style Name. | |
03 | Name of CEO or other primary contact. | |
04 | Additional Executive Name. | |
05 | Former name. | |
06 | Reserved for future use. | |
07 | Name of former CEO or other primary contact. | |
08 | Reserved for future use. | |
09 | Short Abbreviated Name. | Available for limited markets, where applicable. |
10 | Registered Acronym. | Available for limited markets, where applicable. |
11 | Brand name for a brand or product is owned by the subject. | Available for limited markets, where applicable. |
12 | Search Name. | Available for limited markets, where applicable. |
13 | Trademark Name. | Not applicable for United States and Canada. |
14 | Marketing Name. This name is assigned to the business for marketing purposes. Usually this will be a name created by D&B and not one which is officially used by the business. | Not applicable for United States and Canada. |
15 | Known by Name. This is any other name by which the entity is known. |
Not applicable for United States and Canada. |
16 | Reserved for future use. | |
17 | Headquarter Business Name. | Not applicable for United States and Canada. |
18 | Registered Tradestyle Name | Not applicable for United States and Canada. |
19 | Alternative Language Name | Not applicable for United States and Canada. |
20 | Organization Identification Number; full match. The Organization Identification Number is a business identification number used in some countries for business registration and tax collection. Examples include CRO numbers in the U.K. and the French Siren numbers. | |
21 | Reserved for future use. | |
30 | Primary Name, but the legal designator (business type) of the candidate does not match the inquiry business type. | |
31 | Registered Name, but the legal designator (business type) of the candidate does not match the inquiry business type. | Not applicable for United States and Canada. |
32 | Trade Style Name, secondary or additional name used by the business, but the legal designator (business type) of the candidate does not match the inquiry business type. | |
33 | Former Business Name, but the legal designator (business type) of the candidate does not match the inquiry business type. | |
34 | Former Tradestyle Name, but the legal designator (business type) of the candidate does not match the inquiry business type. | Reserved for future use. |
35 | Short or abbreviated name for the business, but the legal designator (business type) of the candidate does not match the inquiry business type. | Available for limited markets, where applicable. |
36 | Registered Acronym, but the legal designator (business type) of the candidate does not match the inquiry business type. | Available for limited markets, where applicable. |
37 | Brand Name, but the legal designator (business type) of the candidate does not match the inquiry business type. | Available for limited markets, where applicable. |
38 | Search Name, but the legal designator (business type) of the candidate does not match the inquiry business type. | Available for limited markets, where applicable. |
39 | Trademark Name, but the legal designator (business type) of the candidate does not match the inquiry business type. | Not applicable for United States and Canada. |
40 | Marketing Name, but the legal designator (business type) of the candidate does not match the inquiry business type. | Not applicable for United States and Canada. |
41 | Known by name, but the legal designator (business type) of the candidate does not match the inquiry business type. | Not applicable for United States and Canada. |
42 | Headquarter Business Name, but the legal designator (business type) of the candidate does not match the inquiry business type. | Not applicable for United States and Canada. |
43 | Registered Tradestyle Name, but the legal designator (business type) of the candidate does not match the inquiry business type. | Not applicable for United States and Canada. |
44 | Alternative Language Name, but the legal designator (business type) of the candidate does not match the inquiry business type. | Not applicable for United States and Canada. |
50 | Domain, the domain resolved from Input URL field. | |
60 | Domain, the domain resolved from Input Email field. | |
98 | No D&B Data exists for this field. | |
99 | No Data in inquiry for this field. | |
97 | Unknown Name Type. |
This code indicates where the number portion of the streetAddressLine1 request value was found. The system does not look for the number in a different address type than Street Name; if found the code will be the same as Street Name Profile Code.
Code | Matched To |
---|---|
00 | Primary Address |
01 | Registered Address |
02 | Former Address |
03 | Additional Address (Executive) |
98 | No D&B Data exists for this field |
99 | No Data in inquiry for this field |
97 | Unknown Address Type |
96 | Unresolved |
This code indicates where the street portion of the streetAddressLine1 request value was found.
Code | Matched To |
---|---|
00 | Primary Address |
01 | Registered Address |
02 | Former Address |
03 | Additional Address (Executive) |
98 | No D&B Data exists for this field |
99 | No Data in inquiry for this field |
97 | Unknown Address Type |
96 | Unresolved |
This code indicates where the locality request value was found.
Code | Matched to |
---|---|
00 | Primary Address |
01 | Registered Address |
02 | Former Address |
03 | Additional Address (Executive) |
04 | Mailing Address |
98 | No D&B Data exists for this field |
99 | No Data in inquiry for this field |
97 | Unknown Address Type |
96 | Unresolved |
This code indicates where the region request value was found.
Code | Matched to |
---|---|
00 | Primary Address |
01 | Registered Address |
02 | Former Address |
03 | Additional Address (Executive) |
98 | No D&B Data exists for this field |
99 | No Data in inquiry for this field |
97 | Unknown Address Type |
96 | Unresolved |
This code indicates where the PO Box value was found.
Code | Matched to |
---|---|
00 | Primary Address |
02 | Former Address |
03 | Additional Address (Executive) |
98 | No D&B Data exists for this field |
99 | No Data in inquiry for this field |
97 | Unknown Address Type |
96 | Unresolved |
This code indicates where the telephoneNumber request value was found.
Code | Matched to |
---|---|
00 | Current Phone |
02 | Former Phone |
98 | No D&B Data exists for this field |
99 | No Data in inquiry for this field |
This code indicates where the postalCode request value was found.
Code | Matched to |
---|---|
00 | Data Present |
98 | No D&B Data exists for this field |
99 | No Data in inquiry for this field |
96 | Unresolved |
This code indicates where the D-U-N-S Number was found.
Code | Matched to |
---|---|
00 | Data Present |
98 | No D&B Data exists for this field |
99 | No Data in inquiry for this field |
Code | Matched to |
---|---|
00 | Data Present |
98 | No D&B Data exists for this field |
99 | No Data in inquiry for this field |
This code indicates the availability of data for this criteria.
Code | Matched to |
---|---|
00 | Data Present |
98 | No D&B Data exists for this field |
99 | No Data in inquiry for this field |
This code indicates the availability of data for this criteria.
Code | Matched to |
---|---|
00 | Data Present |
98 | No D&B Data exists for this field |
99 | No Data in inquiry for this field |
This code indicates the availability of data for this criteria.
Code | Matched to |
---|---|
00 | Data Present |
98 | No D&B Data exists for this field |
99 | No Data in inquiry for this field |
This code indicates where the url or email request value was found.
Code | Matched to |
---|---|
00 | Data Present |
50 | Domain, the domain resolved from Input URL field. |
60 | Domain, the domain resolved from Input Email field. |
98 | No D&B Data exists for this field |
99 | No Data in inquiry for this field |