On-Demand Single Entity Resolution
Also known as Match and Cleanse
| Product Code(s) | Not Applicable |
| Option(s) | None |
| Monitoring Available | No |
| Interface | REST |
| Method | GET |
| Format(s) | JSON |
| Service | Company |
| {version} | 6.0 |
| 6.0 Released On | March 10, 2017 |
The D&B Direct API provides address standardization in two features: On-Demand Single Entity Resolution and On-Demand Address Cleanse & Update. The purpose of these features is to produce machine sortable mailing addresses that are optimized for accurate and quick delivery.
The On-Demand Single Entity Resolution feature provides the added service of matching the resulting "cleansed" information to the D&B database for the purpose of locating a D-U-N-S Number. To access the address cleansing services without the additional lookup, refer to the On-Demand Address Cleanse & Update feature.
Feature Request
IMPORTANT: Please see the new Online Services Security Enhancement Release, effective November 09, 2020.
Overview
For cleansing, a primary address (building number and street name, post office box or rural route number) is required in combination with an organization name, city, state, country and postal code to meet one of the following conditions:
1. For locations within the United States: primary address plus either (a) state abbreviation and ZIP code, (b) city name and ZIP code, or (c) city name with state abbreviation.
2. For locations outside of the United States: country code, primary address plus either (a) state, province or prefecture name and postal code, (b) city name and postal code, or (c) city name with name of the state, province or prefecture.
By default, the standardized address of the customer inputted fields will NOT be returned. An option exists to request that these fields be included in the response.
As an additional option, a D-U-N-S Number may be provided to obtain the mailing address details for a specific organization.
For matching, refer to the On-Demand Entity Identification feature for a list of available options.
Criteria Precedence
The D&B match 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:
- If a D-U-N-S Number is specified, all other parameters will be ignored and a D-U-N-S Number lookup will be performed.
- If a registration number is provided without any additional details, a Registration Number lookup will be performed.
- If a registration number is provided along with subject name or address details, a Registration Number lookup will be performed first. If resulted candidates have low confidence code then match will be performed based on subject name or Address provided.
- If a subject name is provided, a Name & Address lookup will be performed.
- If address details are provided without a subject name, an Address lookup will be performed.
- If a telephone number is provided without a subject name or address details, a Telephone Number lookup will be performed.
- If a zip code is provided, a zip code lookup will be performed.
- If an url alone is provided, a Domain match based on URL will be performed.
- If an email alone is provided, a Domain match based on Email will be performed.
- If both url and email are provided, a Domain match based on URL will be performed.
Regardless of the match type specified, the same algorithm is applied.
Minimum Requirements
The details in this section override the Optional/Required values listed in the Required Parameters table.
- When submitting a request by D-U-N-S Number, a valid D-U-N-S Number is Required. This option is not available for the SBRI variation of the search.
- When submitting a request by Registration Number, a Registration Number and Country Code are Required. This option is not available for the United States (including SBRI search) and Canada.
- When submitting a request by Telephone Number, a Telephone Number and Country Code are Required.
- When submitting a request by Name/Country, an Organization Name (or partial name) and Country Code are Required.
- When submitting a request by Address (United States and Canada), a street address, town, state/territory and Country Code are Required. If a state/territory is not provided, the D&B match engine will revert to a Name/Country match (i.e., street address and town will not be factored into the match).
- When submitting a request by Address (all other countries), a street address, town, and Country Code are Required.
- When submitting a request by Domain, either URL or Email are Required.
Including the building number on the street address will significantly improve the quality of the results.
Global Availability
Data Layer Entitlement
For customers in U.S. and Canadian markets, the API is provisioned for specific collections of products, reports, and/or features (collectively referred to as data layers) for production and trial usage. Entitlement is not required for testing in the sandbox environment.
- This feature is entitled as "On-Demand Single Entity Resolution" for D&B Direct 2.0 customers.
For customers in the UK, Ireland, Belgium, Netherlands and Luxembourg markets, the API is provisioned as a specific set of data layers for production, trial, and sandbox usage.
- This particular data layer is NOT included in the D&B Direct Onboard suite.
Specification
Please refer to the Minimum Requirements section in this topic for scenario specific Required fields.
Sample Request
GET https://direct.dnb.com/V6.0/organizations?CountryISOAlpha2Code=US&SubjectName=Gorman%20Manufacturing&TerritoryName=CA&cleansematch=true
Authorization: <My Token>
Set IncludeCleansedAndStandardizedInformationIndicator to true to have a cleansed copy of the InquiryDetail address fields returned in the response.
Filter:
| Name | Characteristics |
|---|---|
| ApplicationTransactionID | string up to 64 chars., Optional Unique Transaction ID of the request generated by the service |
| TransactionTimestamp | dateTime, Optional The date and time when this request was created. When the request is from an intermediary, such as a workflow manager or service bus, this is the date and time when the message was sent to the D&B function, i.e., the date and time when the xml document was created by the requesting intermediary. |
| SubmittingOfficeID | string up to 64 chars., Optional A number that identifies the system or the software application from where this request originated. / A number used to uniquely identfy the D&B business segment or delivery channel from where this request originated. |
| DUNSNumber | string up to 15 chars. Pattern: {([0-9a-zA-Z]*)}., Optional |
| SubjectName | string up to 240 chars., Optional |
| StreetAddressLine-n (can repeat twice) | string up to 240 chars., Optional |
| PrimaryTownName | string up to 64 chars., Optional |
| CountryISOAlpha2Code | string at least 2 chars. up to 2 chars., Optional Possible values: ISO Alpha2 Code Only |
| TerritoryName | string up to 64 chars., Optional Possible values: Territory Abbreviated Name for US and Canada (eg: NY for New York). Full Territory Name for all other countries |
| FullPostalCode | string up to 32 chars., Optional |
| TelephoneNumber | string at least 1 chars. up to 50 chars., Optional |
| OrganizationIdentificationNumber | string at least 1 chars. up to 40 chars., Optional |
| URLText | string, Optional Text recording the internet URL that uniquely identifies the propreitary website of the subject or the website preferred by the subject which gives more information on the subject. |
| EmailAddress | string, Optional Text recording the electronic mail address used by a subject by which the subject can transmit and or receive text messages, links, and files electronically, typically via a network, like the Internet. |
| CandidateMaximumQuantity | int up to 3 digits., Optional A numeric value indicating the greatest number of candidate subjects that may be included in the result set. |
| ConfidenceLowerLevelThresholdValue | int up to 2 digits., Optional A numeric value from 4 (low) up to 10 (high) indicating the required level of certainty at which a possible Candidate should be included in the result set. |
| ExclusionCriteria-n (Can repeat upto 6 times) | ExclusionDataEnum, Optional Text that denotes an exclusion requirement that the Match process should apply to prevent subjects from being returned as candidates. For example if the value is specified as Out of Business, then the match process should not return any candidates that have an Operating Status which denotes Out Of Business. Possible values: Exclude Non HeadQuarters; Exclude Non MarkeTable Exclude Out of Business; Exclude Undeliverable; Exclude Unreachable |
| IncludeCleansedAndStandardizedInformationIndicator | boolean, Optional When true (set to 1), this denotes that the cleansed and standardized information should be included in the response. When false (set to 0), this denotes that the cleansed and standardized information should not be included in the response. Possible values: true / false |
| CustomerReferenceText-n | string at least 1 chars. up to 240 chars., Optional (up to 5x) A freeform reference string provided by the customer to be linked to the product in order to support subsequent order reconciliation. |
| CustomerBillingEndorsementText | string at least 1 chars. up to 240 chars., Optional Text that is filled in by customer and commonly contains requesting individual or department name, or customer's own account/reference number and/or name for the case on which the product was provided.This text is a reference used during the billing process. |
Endpoint
Use the following endpoint for requesting this feature. The {version} is dependent on the underlying service delivering the response.
NOTE: While "organizations" is part of this endpoint, there is no service by this name. Many D&B Direct calls have a similar structure; however, the {version} component is based on the SERVICE to which a given product is associated.
| REST (Company) |
|---|
| GET https://direct.dnb.com/V{version}/organizations?cleansematch |
Testing
This operation will return a static set of results in the D&B Direct test environment (sandbox), regardless of the request parameters.
Feature Response
NOTE: The D&B Direct REST implementation uses the BadgerFish approach for JSON with some minor variations.
Specification
The following is a list of the possible data fields returned by this operation in the JSON response. Samples are provided for testing successful and failed retrieval, and to demonstrate the basic layout of a response. The data returned in samples may not represent actual values that this feature will deliver.
NOTE: The D-U-N-S Number returned in the response will be a nine-digit zero-padded, numeric value.
Sample Response
{"GetCleanseMatchResponse": {
"TransactionDetail": {
"ServiceTransactionID": "Id-e9a0f95842e36a003edf5d00a1502b23-1",
"TransactionTimestamp": "2017-04-21T02:04:25"
},
"TransactionResult": {
"SeverityText": "Information",
"ResultID": "CM000",
"ResultText": "Success"
},
"GetCleanseMatchResponseDetail": {
"InquiryDetail": {
"SubjectName": "Gorman Manufacturing",
"Address": {
"CountryISOAlpha2Code": "US",
"TerritoryName": "CA"
}
},
"MatchResponseDetail": {
"MatchDataCriteriaText": {"$": "Name and Address Lookup"},
"CandidateMatchedQuantity": 6,
"MatchCandidate": [
{
"DUNSNumber": "804735132",
"OrganizationPrimaryName": {"OrganizationName": {"$": "GORMAN MANUFACTURING COMPANY, INC."}},
"PrimaryAddress": {
"StreetAddressLine": [{"LineText": "492 KOLLER ST"}],
"PrimaryTownName": "SAN FRANCISCO",
"CountryISOAlpha2Code": "US",
"PostalCode": "94110",
"TerritoryAbbreviatedName": "CA",
"UndeliverableIndicator": false
},
"MailingAddress": {
"CountryISOAlpha2Code": "US",
"UndeliverableIndicator": false
},
"TelephoneNumber": {
"TelecommunicationNumber": "6505550000",
"UnreachableIndicator": false
},
"OperatingStatusText": {"$": "Active"},
"FamilyTreeMemberRole": [{"FamilyTreeMemberRoleText": {"$": "Headquarters"}}],
"StandaloneOrganizationIndicator": false,
"MatchQualityInformation": {
"ConfidenceCodeValue": 6,
"MatchBasis": [
{
"EndIndicator": false,
"SubjectTypeText": "Business",
"SeniorPrincipalIndicator": false,
"MatchBasisText": {"$": "Primary Name"}
},
{
"EndIndicator": false,
"SubjectTypeText": "Business",
"SeniorPrincipalIndicator": false,
"MatchBasisText": {"$": "Primary Address"}
}
],
"MatchGradeText": "AZZZAZZZFFZ",
"MatchGradeComponentCount": 11,
"MatchGradeComponent": [
{
"MatchGradeComponentTypeText": {"$": "Name"},
"MatchGradeComponentRating": "A",
"MatchGradeComponentScore": 100
},
{
"MatchGradeComponentTypeText": {"$": "Street Number"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Street Name"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "City"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "State"},
"MatchGradeComponentRating": "A",
"MatchGradeComponentScore": 100
},
{
"MatchGradeComponentTypeText": {"$": "PO Box"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Phone"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Postal Code"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Density"},
"MatchGradeComponentRating": "F",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Uniqueness"},
"MatchGradeComponentRating": "F",
"MatchGradeComponentScore": 20
},
{
"MatchGradeComponentTypeText": {"$": "Sic"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
}
],
"MatchDataProfileText": "0099999900999899000000009898",
"MatchDataProfileComponentCount": 14,
"MatchDataProfileComponent": [
{
"MatchDataProfileComponentTypeText": {"$": "Name"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "Street Number"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "Street Name"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "City"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "State"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "PO Box"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "Phone"},
"MatchDataProfileComponentValue": "98"
},
{
"MatchDataProfileComponentTypeText": {"$": "Postal Code"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "DUNS"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "SIC"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "Density"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "Uniqueness"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "National ID"},
"MatchDataProfileComponentValue": "98"
},
{
"MatchDataProfileComponentTypeText": {"$": "URL"},
"MatchDataProfileComponentValue": "98"
}
]
},
"DisplaySequence": 1
},
{
"DUNSNumber": "038732116",
"OrganizationPrimaryName": {"OrganizationName": {"$": "GORMAN MANUFACTURING COMPANY, INC."}},
"PrimaryAddress": {
"StreetAddressLine": [{"LineText": "1073 S BOYLE AVE"}],
"PrimaryTownName": "LOS ANGELES",
"CountryISOAlpha2Code": "US",
"PostalCode": "90023",
"PostalCodeExtensionCode": "1246",
"TerritoryAbbreviatedName": "CA",
"UndeliverableIndicator": false
},
"MailingAddress": {
"CountryISOAlpha2Code": "US",
"UndeliverableIndicator": false
},
"TelephoneNumber": {
"TelecommunicationNumber": "6505550000",
"UnreachableIndicator": false
},
"OperatingStatusText": {"$": "Active"},
"FamilyTreeMemberRole": [{"FamilyTreeMemberRoleText": {"$": "Branch"}}],
"StandaloneOrganizationIndicator": false,
"MatchQualityInformation": {
"ConfidenceCodeValue": 6,
"MatchBasis": [
{
"EndIndicator": false,
"SubjectTypeText": "Business",
"SeniorPrincipalIndicator": false,
"MatchBasisText": {"$": "Primary Name"}
},
{
"EndIndicator": false,
"SubjectTypeText": "Business",
"SeniorPrincipalIndicator": false,
"MatchBasisText": {"$": "Primary Address"}
}
],
"MatchGradeText": "AZZZAZZZFFZ",
"MatchGradeComponentCount": 11,
"MatchGradeComponent": [
{
"MatchGradeComponentTypeText": {"$": "Name"},
"MatchGradeComponentRating": "A",
"MatchGradeComponentScore": 100
},
{
"MatchGradeComponentTypeText": {"$": "Street Number"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Street Name"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "City"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "State"},
"MatchGradeComponentRating": "A",
"MatchGradeComponentScore": 100
},
{
"MatchGradeComponentTypeText": {"$": "PO Box"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Phone"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Postal Code"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Density"},
"MatchGradeComponentRating": "F",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Uniqueness"},
"MatchGradeComponentRating": "F",
"MatchGradeComponentScore": 20
},
{
"MatchGradeComponentTypeText": {"$": "Sic"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
}
],
"MatchDataProfileText": "0099999900999899000000009898",
"MatchDataProfileComponentCount": 14,
"MatchDataProfileComponent": [
{
"MatchDataProfileComponentTypeText": {"$": "Name"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "Street Number"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "Street Name"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "City"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "State"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "PO Box"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "Phone"},
"MatchDataProfileComponentValue": "98"
},
{
"MatchDataProfileComponentTypeText": {"$": "Postal Code"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "DUNS"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "SIC"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "Density"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "Uniqueness"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "National ID"},
"MatchDataProfileComponentValue": "98"
},
{
"MatchDataProfileComponentTypeText": {"$": "URL"},
"MatchDataProfileComponentValue": "98"
}
]
},
"DisplaySequence": 2
},
{
"DUNSNumber": "362281243",
"OrganizationPrimaryName": {"OrganizationName": {"$": "GORMAN MANUFACTURING COMPANY, INC."}},
"PrimaryAddress": {
"StreetAddressLine": [{"LineText": "1073 S BOYLE AVE"}],
"PrimaryTownName": "LOS ANGELES",
"CountryISOAlpha2Code": "US",
"PostalCode": "90023",
"PostalCodeExtensionCode": "1246",
"TerritoryAbbreviatedName": "CA",
"UndeliverableIndicator": false
},
"MailingAddress": {
"CountryISOAlpha2Code": "US",
"UndeliverableIndicator": false
},
"TelephoneNumber": {
"TelecommunicationNumber": "6505550000",
"UnreachableIndicator": false
},
"OperatingStatusText": {"$": "Active"},
"FamilyTreeMemberRole": [{"FamilyTreeMemberRoleText": {"$": "Branch"}}],
"StandaloneOrganizationIndicator": false,
"MatchQualityInformation": {
"ConfidenceCodeValue": 6,
"MatchBasis": [
{
"EndIndicator": false,
"SubjectTypeText": "Business",
"SeniorPrincipalIndicator": false,
"MatchBasisText": {"$": "Primary Name"}
},
{
"EndIndicator": false,
"SubjectTypeText": "Business",
"SeniorPrincipalIndicator": false,
"MatchBasisText": {"$": "Primary Address"}
}
],
"MatchGradeText": "AZZZAZZZFFZ",
"MatchGradeComponentCount": 11,
"MatchGradeComponent": [
{
"MatchGradeComponentTypeText": {"$": "Name"},
"MatchGradeComponentRating": "A",
"MatchGradeComponentScore": 100
},
{
"MatchGradeComponentTypeText": {"$": "Street Number"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Street Name"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "City"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "State"},
"MatchGradeComponentRating": "A",
"MatchGradeComponentScore": 100
},
{
"MatchGradeComponentTypeText": {"$": "PO Box"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Phone"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Postal Code"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Density"},
"MatchGradeComponentRating": "F",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Uniqueness"},
"MatchGradeComponentRating": "F",
"MatchGradeComponentScore": 20
},
{
"MatchGradeComponentTypeText": {"$": "Sic"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
}
],
"MatchDataProfileText": "0099999900999899000000009898",
"MatchDataProfileComponentCount": 14,
"MatchDataProfileComponent": [
{
"MatchDataProfileComponentTypeText": {"$": "Name"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "Street Number"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "Street Name"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "City"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "State"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "PO Box"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "Phone"},
"MatchDataProfileComponentValue": "98"
},
{
"MatchDataProfileComponentTypeText": {"$": "Postal Code"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "DUNS"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "SIC"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "Density"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "Uniqueness"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "National ID"},
"MatchDataProfileComponentValue": "98"
},
{
"MatchDataProfileComponentTypeText": {"$": "URL"},
"MatchDataProfileComponentValue": "98"
}
]
},
"DisplaySequence": 3
},
{
"DUNSNumber": "009175688",
"OrganizationPrimaryName": {"OrganizationName": {"$": "GORMAN MFG CO INC"}},
"PrimaryAddress": {
"StreetAddressLine": [{"LineText": "8129 JUNIPERO ST STE A"}],
"PrimaryTownName": "SACRAMENTO",
"CountryISOAlpha2Code": "US",
"PostalCode": "95828",
"PostalCodeExtensionCode": "1603",
"TerritoryAbbreviatedName": "CA",
"UndeliverableIndicator": false
},
"MailingAddress": {
"StreetAddressLine": [{"LineText": "PO BOX 756"}],
"PrimaryTownName": "WOODLAND",
"CountryISOAlpha2Code": "US",
"PostalCode": "95776",
"TerritoryAbbreviatedName": "CA",
"UndeliverableIndicator": false
},
"TelephoneNumber": {
"TelecommunicationNumber": "5306620211",
"UnreachableIndicator": false
},
"OperatingStatusText": {"$": "Out of Business"},
"StandaloneOrganizationIndicator": true,
"MatchQualityInformation": {
"ConfidenceCodeValue": 6,
"MatchBasis": [
{
"EndIndicator": false,
"SubjectTypeText": "Business",
"SeniorPrincipalIndicator": false,
"MatchBasisText": {"$": "Primary Name"}
},
{
"EndIndicator": false,
"SubjectTypeText": "Business",
"SeniorPrincipalIndicator": false,
"MatchBasisText": {"$": "Primary Address"}
}
],
"MatchGradeText": "AZZZAZZZFFZ",
"MatchGradeComponentCount": 11,
"MatchGradeComponent": [
{
"MatchGradeComponentTypeText": {"$": "Name"},
"MatchGradeComponentRating": "A",
"MatchGradeComponentScore": 100
},
{
"MatchGradeComponentTypeText": {"$": "Street Number"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Street Name"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "City"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "State"},
"MatchGradeComponentRating": "A",
"MatchGradeComponentScore": 100
},
{
"MatchGradeComponentTypeText": {"$": "PO Box"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Phone"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Postal Code"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Density"},
"MatchGradeComponentRating": "F",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Uniqueness"},
"MatchGradeComponentRating": "F",
"MatchGradeComponentScore": 20
},
{
"MatchGradeComponentTypeText": {"$": "Sic"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
}
],
"MatchDataProfileText": "0099999900999899000000009898",
"MatchDataProfileComponentCount": 14,
"MatchDataProfileComponent": [
{
"MatchDataProfileComponentTypeText": {"$": "Name"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "Street Number"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "Street Name"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "City"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "State"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "PO Box"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "Phone"},
"MatchDataProfileComponentValue": "98"
},
{
"MatchDataProfileComponentTypeText": {"$": "Postal Code"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "DUNS"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "SIC"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "Density"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "Uniqueness"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "National ID"},
"MatchDataProfileComponentValue": "98"
},
{
"MatchDataProfileComponentTypeText": {"$": "URL"},
"MatchDataProfileComponentValue": "98"
}
]
},
"DisplaySequence": 4
},
{
"DUNSNumber": "199650169",
"OrganizationPrimaryName": {"OrganizationName": {"$": "GORMAN, DENNIS"}},
"TradeStyleName": {"OrganizationName": {"$": "GORMAN MANUFACTURING"}},
"PrimaryAddress": {
"StreetAddressLine": [{"LineText": "12 W KENTUCKY AVE"}],
"PrimaryTownName": "WOODLAND",
"CountryISOAlpha2Code": "US",
"PostalCode": "95695",
"PostalCodeExtensionCode": "5837",
"TerritoryAbbreviatedName": "CA",
"UndeliverableIndicator": false
},
"MailingAddress": {
"CountryISOAlpha2Code": "US",
"UndeliverableIndicator": false
},
"TelephoneNumber": {
"TelecommunicationNumber": "5306627750",
"UnreachableIndicator": false
},
"OperatingStatusText": {"$": "Out of Business"},
"StandaloneOrganizationIndicator": true,
"MatchQualityInformation": {
"ConfidenceCodeValue": 6,
"MatchBasis": [
{
"EndIndicator": false,
"SubjectTypeText": "Business",
"SeniorPrincipalIndicator": false,
"MatchBasisText": {"$": "Trade style"}
},
{
"EndIndicator": false,
"SubjectTypeText": "Business",
"SeniorPrincipalIndicator": false,
"MatchBasisText": {"$": "Primary Address"}
}
],
"MatchGradeText": "AZZZAZZZBFZ",
"MatchGradeComponentCount": 11,
"MatchGradeComponent": [
{
"MatchGradeComponentTypeText": {"$": "Name"},
"MatchGradeComponentRating": "A",
"MatchGradeComponentScore": 100
},
{
"MatchGradeComponentTypeText": {"$": "Street Number"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Street Name"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "City"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "State"},
"MatchGradeComponentRating": "A",
"MatchGradeComponentScore": 100
},
{
"MatchGradeComponentTypeText": {"$": "PO Box"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Phone"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Postal Code"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Density"},
"MatchGradeComponentRating": "B",
"MatchGradeComponentScore": 51
},
{
"MatchGradeComponentTypeText": {"$": "Uniqueness"},
"MatchGradeComponentRating": "F",
"MatchGradeComponentScore": 20
},
{
"MatchGradeComponentTypeText": {"$": "Sic"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
}
],
"MatchDataProfileText": "0299999900999899000000009898",
"MatchDataProfileComponentCount": 14,
"MatchDataProfileComponent": [
{
"MatchDataProfileComponentTypeText": {"$": "Name"},
"MatchDataProfileComponentValue": "02"
},
{
"MatchDataProfileComponentTypeText": {"$": "Street Number"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "Street Name"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "City"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "State"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "PO Box"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "Phone"},
"MatchDataProfileComponentValue": "98"
},
{
"MatchDataProfileComponentTypeText": {"$": "Postal Code"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "DUNS"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "SIC"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "Density"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "Uniqueness"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "National ID"},
"MatchDataProfileComponentValue": "98"
},
{
"MatchDataProfileComponentTypeText": {"$": "URL"},
"MatchDataProfileComponentValue": "98"
}
]
},
"DisplaySequence": 5
},
{
"DUNSNumber": "088847942",
"OrganizationPrimaryName": {"OrganizationName": {"$": "GORMAN MFG & SUPPLY CO"}},
"PrimaryAddress": {
"StreetAddressLine": [{"LineText": "6516 MATTOS LN"}],
"PrimaryTownName": "SACRAMENTO",
"CountryISOAlpha2Code": "US",
"PostalCode": "95829",
"PostalCodeExtensionCode": "9309",
"TerritoryAbbreviatedName": "CA",
"UndeliverableIndicator": false
},
"MailingAddress": {
"CountryISOAlpha2Code": "US",
"UndeliverableIndicator": false
},
"TelephoneNumber": {
"TelecommunicationNumber": "9163810282",
"UnreachableIndicator": false
},
"OperatingStatusText": {"$": "Out of Business"},
"StandaloneOrganizationIndicator": true,
"MatchQualityInformation": {
"ConfidenceCodeValue": 6,
"MatchBasis": [
{
"EndIndicator": false,
"SubjectTypeText": "Business",
"SeniorPrincipalIndicator": false,
"MatchBasisText": {"$": "Primary Name"}
},
{
"EndIndicator": false,
"SubjectTypeText": "Business",
"SeniorPrincipalIndicator": false,
"MatchBasisText": {"$": "Primary Address"}
}
],
"MatchGradeText": "AZZZAZZZFFZ",
"MatchGradeComponentCount": 11,
"MatchGradeComponent": [
{
"MatchGradeComponentTypeText": {"$": "Name"},
"MatchGradeComponentRating": "A",
"MatchGradeComponentScore": 80
},
{
"MatchGradeComponentTypeText": {"$": "Street Number"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Street Name"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "City"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "State"},
"MatchGradeComponentRating": "A",
"MatchGradeComponentScore": 100
},
{
"MatchGradeComponentTypeText": {"$": "PO Box"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Phone"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Postal Code"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Density"},
"MatchGradeComponentRating": "F",
"MatchGradeComponentScore": 0
},
{
"MatchGradeComponentTypeText": {"$": "Uniqueness"},
"MatchGradeComponentRating": "F",
"MatchGradeComponentScore": 20
},
{
"MatchGradeComponentTypeText": {"$": "Sic"},
"MatchGradeComponentRating": "Z",
"MatchGradeComponentScore": 0
}
],
"MatchDataProfileText": "0099999900999899000000009898",
"MatchDataProfileComponentCount": 14,
"MatchDataProfileComponent": [
{
"MatchDataProfileComponentTypeText": {"$": "Name"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "Street Number"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "Street Name"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "City"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "State"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "PO Box"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "Phone"},
"MatchDataProfileComponentValue": "98"
},
{
"MatchDataProfileComponentTypeText": {"$": "Postal Code"},
"MatchDataProfileComponentValue": "99"
},
{
"MatchDataProfileComponentTypeText": {"$": "DUNS"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "SIC"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "Density"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "Uniqueness"},
"MatchDataProfileComponentValue": "00"
},
{
"MatchDataProfileComponentTypeText": {"$": "National ID"},
"MatchDataProfileComponentValue": "98"
},
{
"MatchDataProfileComponentTypeText": {"$": "URL"},
"MatchDataProfileComponentValue": "98"
}
]
},
"DisplaySequence": 6
}
]
}
}
}}
Filter:
Lists of possible values (when present) are subject to change. Additional values not presented in this documentation may be delivered in the response and should be anticipated in any implementation.
Empty/NULL Values
A NULL returned for an element indicates that the information was not provided to D&B when the related data items were collected. The absence of a value for a particular item should not be considered indicative of any implied value (e.g., NULL for a boolean indicator is NOT the same as a value of 'false').
Abbreviated Territory Names
When present, the Territory Abbreviated Name field will contain local abbreviations, which may be based on standard designations. For companies domiciled in the United States or Canada, this field will contain the second component of ISO 3166-2 codes. For example, the ISO 3166-2:US code for New Jersey is "US-NJ" and the value "NJ" will be delivered in this field. Similarly, the ISO 3166-2:CA code for Ontario is "CA-ON" and the value "ON" will be delivered in this field.
Language/Character Sets
The text contained within D&B Direct 2.0 data layers is returned in English. Several reports, including the D&B Business Information Report (BIR), provide additional language options. Data layers are encoded using the ISO 8859-1 character set standard (sometimes referred to as Latin-1), EXCEPT when the organization is domiciled in the Czech Republic (CZ), Hungary (HU), Poland (PL) or Slovakia (SK). Data from these markets is currently encoded using the ISO 8859-2 character set standard.
Response Codes & Error Handling
Successful service requests will return a CM000 response code in the TransactionResult ResultID field. Otherwise, one of the D&B Direct standard response codes will be returned.
This operation may return the following response codes: CM001, CM002, CM003, CM004, CM007, CM008, CM009, CM011, CM012, CM016, CP001, CP003, CP004, and SC001-SC009.
D&B Direct 2.0 API requests are provided on a metered basis; and may require entitlement prior to use in the production environment. In addition, a concurrency limit (QPS) is monitored to ensure that it is not exceeded. An error code will be returned in the event that a transaction is throttled.
Qualified usage (e.g., a successful response) is tracked and billed according to the terms & conditions of the customer's contract. The response codes CM000, CM010, PD002 and PD015 are considered successful. A built-in feature exists to prevent duplicate billing when multiple successful requests with the same criteria are submitted on the same calendar day (which is based on Eastern Standard Time [GMT-5]).
Business Elements
While D&B Direct uses a product canonical naming model in the request/response, many customers may be more familiar with the following business element labels.
Filter:
| Name | Description |
|---|---|
| Branch/Headquarter Indicator | A character code that describes the case that the data relates to as a branch or headquarters location. PCM XPath: //MatchCandidate/ FamilyTreeMemberRole/ FamilyTreeMemberRoleText |
| Confidence Code | Confidence Code (CC) indicates the degree of Match between an Inquiry and a Match Result. PCM XPath: //MatchCandidate/ MatchQualityInformation/ ConfidenceCodeValue |
| Country/Market Code | ISO Code for the country/market where the business is located. PCM XPath: //MatchCandidate/ PrimaryAddress/ CountryISOAlpha2Code |
| Delivery Point Validation CMRA | BR: Y - The address is a valid Commercial Mail Receiving Agency (CMRA). A CMRA is a private business that accepts mail delivery from the Postal Service for others (addressee), holds it for pickup (in most cases a private mailbox ("PMB") or re-mails it to PCM XPath: //StandardizedAddress/ DeliveryPointValidationDetail/ CMRAValue |
| Delivery Point Validation STATUS | BR: Y - Submitted address is valid, including, if required for delivery, the secondary address: suite, room, floor or apartment #. This is equal to DSF Deliverability Indicator #1. N - Submitted address is invalid and possibly to definitely undeliverable. PCM XPath: //StandardizedAddress/ DeliveryPointValidationDetail/ StatusValue |
| D-U-N-S Number | DUNS Number of the organization PCM XPath: //MatchCandidate/ DUNSNumber |
| Mailing Address (NIXIE) Undeliverable | Indicates whether the address is undeliverable. PCM XPath: //MatchCandidate/ MailingAddress/ UndeliverableIndicator |
| Mailing Country/Market Code | The three digit code associated with the country/market name of the mailing address. PCM XPath: //MatchCandidate/ MailingAddress/ CountryISOAlpha2Code |
| Mailing Postal Code | The postal or ZIP code associated with the mailing address. PCM XPath: //MatchCandidate/ MailingAddress/ PostalCode |
| Mailing Postal Code Extension | PCM XPath: //MatchCandidate/ MailingAddress/ PostalCodeExtensionCode |
| Mailing Street Address | Present only if the business has a mailing address in addition to a physical address. Up to 2 Mail Address fields. PCM XPath: //MatchCandidate/ MailingAddress/ StreetAddressLine/ LineText |
| Mailing Territory Abbreviated Name | The abbreviation of the mailing state/Province/Primary region. PCM XPath: //MatchCandidate/ MailingAddress/ TerritoryAbbreviatedName |
| Mailing Town Name | The mailing city associated with the mailing address. PCM XPath: //MatchCandidate/ MailingAddress/ PrimaryTownName |
| Match Criteria | PCM XPath: //MatchDataCriteriaText |
| Match Data Profile (Combined) | Indicates how a single attribute matched to additional data that is present on the Match Reference file. PCM XPath: //MatchCandidate/ MatchQualityInformation/ MatchDataProfileText |
| Match Data Profile Quantity | The total number of constituent parts (e.g., Name, Street Number) that were used in the calculation of the Match Data Profile. PCM XPath: //MatchCandidate/ MatchQualityInformation/ MatchDataProfileComponentCount |
| Match Grade (Combined) | Currently, Match Grades are represented as either a 7 or 11 Character String. Below is the Order of the Match Grade Attributes: PCM XPath: //MatchCandidate/ MatchQualityInformation/ MatchGradeText |
| Match Grade Component Quantity | The total number of constituent parts (e.g., Name, Street Number) that were used in the calculation of the Match Grade. PCM XPath: //MatchCandidate/ MatchQualityInformation/ MatchGradeComponentCount |
| Most Senior Principal Full Name | Name of the primary executive of the company. PCM XPath: //MatchCandidate/ SeniorPrincipalName/ FullName |
| Number Of Candidates | PCM XPath: //CandidateMatchedQuantity |
| Organization Identification Number | Registration numbers assigned to the organization PCM XPath: //MatchCandidate/ OrganizationIdentificationNumberDetail/ OrganizationIdentificationNumber |
| Out of Business Indicator | PCM XPath: //MatchCandidate/ OperatingStatusText |
| Postal Code | Postal (ZIP) code where business is located. PCM XPath: //MatchCandidate/ PrimaryAddress/ PostalCode |
| Postal Code Extension | PCM XPath: //MatchCandidate/ PrimaryAddress/ PostalCodeExtensionCode |
| Primary Business Name | The official or registered name of the business. PCM XPath: //MatchCandidate/ OrganizationPrimaryName/ OrganizationName |
| Standalone Organization Indicator | PCM XPath: //MatchCandidate/ StandaloneOrganizationIndicator |
| Standardized Address Address Type | PCM XPath: //StandardizedAddress/ AddressTypeValue |
| Standardized Address Business Name | PCM XPath: //StandardizedName/ OrganizationName |
| Standardized Address Country/Market Code | PCM XPath: //StandardizedAddress/ CountryISOAlpha2Code |
| Standardized Address Country Name | PCM XPath: //StandardizedAddress/ CountryName |
| Standardized Address County | PCM XPath: //StandardizedAddress/ CountyName |
| Standardized Address Inexact Indicator | PCM XPath: //StandardizedAddress/ InexactAddressIndicator |
| Standardized Address Postal Code | Zip code from inquiry request PCM XPath: //StandardizedAddress/ PostalCode |
| Standardized Address Street | PCM XPath: //StandardizedAddress/ StreetAddressLine/ LineText |
| Standardized Address Territory | PCM XPath: //StandardizedAddress/ TerritoryName |
| Standardized Address Territory Abbreviated Name | PCM XPath: //StandardizedAddress/ TerritoryAbbreviatedName |
| Street Address | Address line of physical location PCM XPath: //MatchCandidate/ PrimaryAddress/ StreetAddressLine/ LineText |
| Telephone Disconnected (TIXIE) Indicator | Indicates whether the phone number is invalid. PCM XPath: //MatchCandidate/ TelephoneNumber/ UnreachableIndicator |
| Telephone Number | The telephone number of the business. PCM XPath: //MatchCandidate/ TelephoneNumber/ TelecommunicationNumber |
| Telephone Number International Dialing Code | International dialing code for country PCM XPath: //MatchCandidate/ TelephoneNumber/ InternationalDialingCode |
| Territory Abbreviated Name | The abbreviation for the state/province/primary region where the business is located. PCM XPath: //MatchCandidate/ PrimaryAddress/ TerritoryAbbreviatedName |
| Town Name | The name of the city or town in which the business is physically located. PCM XPath: //MatchCandidate/ PrimaryAddress/ PrimaryTownName |
| Trade Style Name | PCM XPath: //MatchCandidate/ TradeStyleName/ OrganizationName |
The preceding list is not presented in the order, nor manner, in which the information is packaged and delivered via the D&B Direct API. Legend: [C] = may be included in a Custom Data product; [M] = may be referenced by the Monitoring process; [M+] = Monitored using an aggregate or attribute XPath.
Feature Notes
When a multi-line address is provided (e.g. building number, street name and post office box in a single request), this feature will return the proper address for mailing purposes.
Match Data Profile (MDP)
The Match Data Profile provides specific detail for each position of the Match Grade by describing how the input field values were matched to the D&B record values. For each of the fourteen MDP components, a two-digit numeric code identifying the type of the information used in the comparison will be returned.
Filter:
| Component | Possible Values | Additional Details |
|---|---|---|
| Name | 00 to 44, 50, 60, 97-99 | |
| Street Number | 00-03, 96, 98-99 | |
| Street Name | 00-03, 96, 98-99 | |
| City | 00-03, 96, 98-99 | Town Name |
| State | 00-03, 96, 98-99 | Territory Name (e.g. may be a Province for Canadian companies) |
| PO Box | 00, 02-03, 96, 98-99 | Post Office Box Number |
| Phone | 00, 02, 98-99 | Telephone Number |
| Postal Code | 00, 96, 98-99 | |
| DUNS | 00, 98-99 | D-U-N-S Number |
| SIC | 00, 98-99 | Standard Industrial Classification |
| Density | 00, 98-99 | Defined as the number of businesses within the inquiry subject's postal region (e.g. within a given ZIP code for U.S. companies). |
| Uniqueness | 00, 98-99 | Defined as the number of unique matches for the inquiry subject name in the D&B database. |
| National ID | 00, 20, 98-99 | Organization Identification Number |
| URL | 00, 50, 60, 98-99 | Web Site Address |
1 Reserved for future use.
2 Applicable for Iberia, Benelux, Italy and San Marino only.
3 Applicable for Italy and San Marino only.
4 Not applicable for United States and Canada.
What to do Next
- Small Batch Cleanse Process (up to 100 companies per batch)
- Medium Batch Cleanse Process (up to 10,000 companies per batch)
- © Dun & Bradstreet, Inc. 2019 – 2025. All rights reserved.