Loading

Direct 2.0
Collapse

On-Demand Single Entity Resolution

Also known as Match and Cleanse

Product Code(s)Not Applicable
Option(s)None
Monitoring AvailableNo
InterfaceREST
MethodGET
Format(s)JSON
ServiceCompany
{version}6.0
6.0 Released OnMarch 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.

Update History

  • January 27, 2017 (vALL SOAP & REST): Added Match Data Profile operations section to Cleanse Match.
  • July 10, 2015 (v5.0 SOAP & REST): The floating point precision for MatchGradeComponentScore has been increased to 21 digits.
  • July 10, 2015 (All Versions): Requests for country codes BV, CU, GS, IM, KP, MN, BQ, CW, SX, NU, PW, TL, UM, and WF will return a CM007 response code instead of PD005.
  • July 10, 2015 (v5.0 SOAP/REST): Requests for companies domiciled in Germany (country code DE) require that an OrderReasonCode value be included per local regulations. The response code CM003 will be returned if the parameter is missing or a CM001 if the value is not valid.

Feature Request

IMPORTANT: Please see the new Online Services Security Enhancement Release, effective December 14, 2018.

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:

  1. 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.
  2. If a subject name is provided, a Name & Address lookup will be performed.
  3. If address details are provided without a subject name, an Address lookup will be performed.
  4. If a telephone number is provided without a subject name or address details, a Telephone Number lookup will be performed.
  5. If a registration number is provided without any additional details, a Registration Number lookup will be performed.
  6. If a zip code is provided, a zip code lookup will be performed.
  7. If an url alone is provided, a Domain match based on URL will be performed.
  8. If an email alone is provided, a Domain match based on Email will be performed.
  9. 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

The Company_GetCleanseMatch data layer is available for businesses domiciled in the following countries:

CountryISO Code
United States of AmericaUS
BelgiumBE
FranceFR
GermanyDE
ItalyIT
NetherlandsNL
PortugalPT
SpainES
United KingdomGB
AustraliaAU
New ZealandNZ
AndorraAD
AnguillaAI
Antigua & BarbudaAG
ArubaAW
BahamasBS
BarbadosBB
BelizeBZ
BermudaBM
BoliviaBO
British Virgin IslandsVG
CanadaCA
Cayman IslandsKY
ChileCL
ColombiaCO
Costa RicaCR
DenmarkDK
DominicaDM
Dominican RepublicDO
EcuadorEC
El SalvadorSV
Faero IslandsFO
FinlandFI
GreenlandGL
GrenadaGD
GuatemalaGT
GuyanaGY
HaitiHT
HondurasHN
IrelandIE
JamaicaJM
JapanJP
LuxembourgLU
MexicoMX
MonacoMC
MontserratMS
Netherlands AntillesAN
Bonaire, Sint Eustatius And SabaBQ
CuraçaoCW
Sint Maarten (dutch)SX
NicaraguaNI
NorwayNO
PanamaPA
Saint Kitts & NevisKN
Saint LuciaLC
Saint VincentVC
San MarinoSM
SurinameSR
SwedenSE
Taiwan (republic of China)TW
Trinidad And TobagoTT
Turks And CaicosTC
VenezuelaVE
AfghanistanAF
AlbaniaAL
AlgeriaDZ
American SamoaAS
AngolaAO
ArgentinaAR
ArmeniaAM
AustriaAT
AzerbaijanAZ
BahrainBH
BangladeshBD
Benin, Peoples Republic ofBJ
BhutanBT
Bosnia And HerzegovinaBA
BotswanaBW
BrazilBR
BruneiBN
BulgariaBG
Burkina FasoBF
Burma (myanmar)MM
BurundiBI
BelarusBY
Kampuchea (prev. Cambodia)KH
CameroonCM
Cape Verde, Republic ofCV
Central Africa RepublicCF
Chad, Republic ofTD
China, Peoples Republic ofCN
Christmas IslandCX
Comoros RepublicKM
Congo Democratic RepublicCD
Cook IslandsCK
CroatiaHR
CyprusCY
Turkish Republic of Northern CyprusXT
Czech RepublicCZ
DjiboutiDJ
EgyptEG
Equatorial GuineaGQ
EritreaER
EstoniaEE
EthiopiaET
Falkland IslandsFK
FijiFJ
French GuianaGF
French Polynesia/tahitiPF
Gabon RepublicGA
GambiaGM
GeorgiaGE
GhanaGH
GibraltarGI
GreeceGR
GuadeloupeGP
GuamGU
Guinea BissauGW
Guinea, Republic ofGN
Hong KongHK
HungaryHU
IcelandIS
IndiaIN
IndonesiaID
IranIR
IraqIQ
IsraelIL
Ivory Coast/cote D'ivoireCI
JordanJO
KazakhstanKZ
KenyaKE
KiribatiKI
Korea, Republic ofKR
KuwaitKW
KyrgyzstanKG
LaosLA
LatviaLV
LebanonLB
LesothoLS
LiberiaLR
LibyaLY
LiechtensteinLI
LithuaniaLT
MacauMO
MacedoniaMK
MadagasgarMG
MalawiMW
MalaysiaMY
MaldivesMV
MaliML
MaltaMT
Marianas IslandsMP
Marshall IslandsMH
MartiniqueMQ
MauritaniaMR
MauritiusMU
MoldovaMD
MontenegroME
MoroccoMA
MozambiqueMZ
NamibiaNA
NauruNR
NepalNP
New CaledoniaNC
NigerNE
NigeriaNG
Norfolk IslandNF
OmanOM
PakistanPK
Papua New GuineaPG
ParaguayPY
PeruPE
PhilippinesPH
PolandPL
QatarQA
Reunion IslandRE
RomaniaRO
Russian FederationRU
RwandaRW
Saint HelenaSH
Saint Pierre Et MiquelonPM
Sao Tome & PrincipeST
Saudi ArabiaSA
SenegalSN
SerbiaRS
SeychellesSC
Sierra LeoneSL
SingaporeSG
SlovakiaSK
SloveniaSI
Solomon IslandsSB
SomaliaSO
South AfricaZA
Sri LankaLK
SudanSD
South SudanSS
SwazilandSZ
SwitzerlandCH
SyriaSY
TajhikstanTJ
TanzaniaTZ
ThailandTH
TogoTG
Tokelau IslandsTK
TongaTO
TunisiaTN
TurkeyTR
TurkmenistanTM
TuvaluTV
UgandaUG
UkraineUA
United Arab EmiratesAE
UruguayUY
UzbekistanUZ
VanuatuVU
VietnamVN
Western SamoaWS
YemenYE
ZambiaZM
ZimbabweZW
CongoCG
Puerto RicoPR
Holy See (vatican City State)VA
Serbia & MontenegroCS
KosovoXK
Micronesia, Federated States ofFM

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.

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
            }
         ]
      }
   }
}}


Name Characteristics
GetCleanseMatchResponse Aggregate
GetCleanseMatchResponse @schemaLocation Attribute
GetCleanseMatchResponse { TransactionDetail Aggregate, Required

Records information necessary to process a particular request. Examples of a request is the ordering of a product.

GetCleanseMatchResponse { TransactionDetail { ApplicationTransactionID string up to 64 chars., Optional

Unique Transaction ID of the request generated by the service

GetCleanseMatchResponse { TransactionDetail { ServiceTransactionID string up to 64 chars., Required

A number assigned by the D&B service to uniquely identify this transaction.

GetCleanseMatchResponse { TransactionDetail { TransactionTimestamp dateTime, Required

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.

End: GetCleanseMatchResponse } TransactionDetail /Aggregate
GetCleanseMatchResponse { TransactionResult Aggregate, Required

An aggregate that can repeat multiple times to record the different outcomes of the transaction.

GetCleanseMatchResponse { TransactionResult { SeverityText string, Required

Text that records the criticality of the outcome, e.g., Information, Warning, Error, Fatal.

GetCleanseMatchResponse { TransactionResult { ResultID string up to 32 chars., Required

An alphanumeric string that uniquely identifies the outcome of the transaction.

GetCleanseMatchResponse { TransactionResult { ResultText string up to 512 chars., Optional

Text that explains the outcome of the transaction.

GetCleanseMatchResponse { TransactionResult { ResultMessage Aggregate, Optional (Array)

An aggregate that can repeat multiple times to record textual data that expands on the ResultID and ResultText to provide additional information to the user regarding the status of the transaction. If the status implies that there is a problem this may also provide guidance to the user on how to address it.

GetCleanseMatchResponse { TransactionResult { ResultMessage { ResultDescription string up to 512 chars., Required

Text that describes the additional information regarding the outcome of the transaction.

End: GetCleanseMatchResponse } TransactionResult } ResultMessage /Aggregate
End: GetCleanseMatchResponse } TransactionResult /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail Aggregate, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { InquiryDetail Aggregate, Required
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { InquiryDetail { DUNSNumber string up to 15 chars. Pattern: {([0-9a-zA-Z]*)}., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { InquiryDetail { SubjectName string up to 240 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { InquiryDetail { Address Aggregate, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { InquiryDetail { Address { StreetAddressLine Aggregate, Optional (Array)
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { InquiryDetail { Address { StreetAddressLine { LineText string up to 240 chars., Required
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } InquiryDetail } Address } StreetAddressLine /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { InquiryDetail { Address { PrimaryTownName string up to 64 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { InquiryDetail { Address { CountryISOAlpha2Code string at least 2 chars. up to 2 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { InquiryDetail { Address { TerritoryName string up to 64 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { InquiryDetail { Address { FullPostalCode string up to 32 chars., Optional
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } InquiryDetail } Address /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { InquiryDetail { TelephoneNumber Aggregate, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { InquiryDetail { TelephoneNumber { TelecommunicationNumber string at least 1 chars. up to 50 chars., Required
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } InquiryDetail } TelephoneNumber /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { InquiryDetail { OrganizationIdentificationNumberDetail Aggregate, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { InquiryDetail { OrganizationIdentificationNumberDetail @DNBCodeTableNumber Attribute
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { InquiryDetail { OrganizationIdentificationNumberDetail @DNBCodeValue Attribute
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { InquiryDetail { OrganizationIdentificationNumberDetail @TypeText Attribute
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { InquiryDetail { OrganizationIdentificationNumberDetail { OrganizationIdentificationNumber string at least 1 chars. up to 40 chars., Required
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } InquiryDetail } OrganizationIdentificationNumberDetail /Aggregate
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } InquiryDetail /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail Aggregate, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchDataCriteriaText string up to 256 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchDataCriteriaText @DNBCodeValue Attribute
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchDataCriteriaText @DNBCodeTableNumber Attribute
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { CandidateMatchedQuantity int up to 3 digits., Required
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate Aggregate, Optional (Array)
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { DUNSNumber string up to 15 chars. Pattern: {([0-9a-zA-Z]*)}., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { OrganizationPrimaryName Aggregate, Required
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { OrganizationPrimaryName { OrganizationName string up to 256 chars., Required
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } MatchResponseDetail } MatchCandidate } OrganizationPrimaryName /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { TradeStyleName Aggregate, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { TradeStyleName { OrganizationName string up to 256 chars., Required
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } MatchResponseDetail } MatchCandidate } TradeStyleName /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { SeniorPrincipalName Aggregate, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { SeniorPrincipalName { FullName string up to 240 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { PrimaryAddress Aggregate, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { PrimaryAddress { StreetAddressLine Aggregate, Optional (Array)
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { PrimaryAddress { StreetAddressLine { LineText string up to 240 chars., Required
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } MatchResponseDetail } MatchCandidate } PrimaryAddress } StreetAddressLine /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { PrimaryAddress { PrimaryTownName string up to 64 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { PrimaryAddress { CountryISOAlpha2Code string at least 2 chars. up to 2 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { PrimaryAddress { PostalCode string up to 16 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { PrimaryAddress { PostalCodeExtensionCode string up to 16 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { PrimaryAddress { TerritoryAbbreviatedName string up to 64 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { PrimaryAddress { UndeliverableIndicator Attribute, Optional
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } MatchResponseDetail } MatchCandidate } PrimaryAddress /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MailingAddress Aggregate, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MailingAddress { StreetAddressLine Aggregate, Optional (Array)
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MailingAddress { StreetAddressLine { LineText string up to 240 chars., Required
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } MatchResponseDetail } MatchCandidate } MailingAddress } StreetAddressLine /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MailingAddress { PrimaryTownName string up to 64 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MailingAddress { CountryISOAlpha2Code string at least 2 chars. up to 2 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MailingAddress { PostalCode string up to 16 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MailingAddress { PostalCodeExtensionCode string up to 16 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MailingAddress { TerritoryAbbreviatedName string up to 64 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MailingAddress { UndeliverableIndicator boolean, Optional
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } MatchResponseDetail } MatchCandidate } MailingAddress /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { TelephoneNumber Aggregate, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { TelephoneNumber { TelecommunicationNumber string at least 1 chars. up to 50 chars., Required
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { TelephoneNumber { InternationalDialingCode int up to 7 digits., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { TelephoneNumber { UnreachableIndicator boolean, Optional
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } MatchResponseDetail } MatchCandidate } TelephoneNumber /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { OperatingStatusText string up to 256 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { FamilyTreeMemberRole Aggregate, Optional (Array)
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { FamilyTreeMemberRole { FamilyTreeMemberRoleText string up to 256 chars., Optional

Possible values: Headquarters; Subsidiary; Branch

End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } MatchResponseDetail } MatchCandidate } FamilyTreeMemberRole /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { StandaloneOrganizationIndicator boolean, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { OrganizationIdentificationNumberDetail Aggregate, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { OrganizationIdentificationNumberDetail @DNBCodeTableNumber Attribute
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { OrganizationIdentificationNumberDetail @DNBCodeValue Attribute
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { OrganizationIdentificationNumberDetail @TypeText Attribute
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { OrganizationIdentificationNumberDetail { OrganizationIdentificationNumber string at least 1 chars. up to 40 chars., Required
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } MatchResponseDetail } MatchCandidate } OrganizationIdentificationNumberDetail /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation Aggregate, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { ConfidenceCodeValue int up to 2 digits., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchBasis Aggregate, Optional (Array)
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchBasis { EndIndicator boolean, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchBasis { SubjectTypeText SubjectType, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchBasis { SeniorPrincipalIndicator boolean, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchBasis { MatchBasisText string up to 256 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchBasis { MatchBasisText @DNBCodeValue Attribute
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchBasis { MatchBasisText @DNBCodeTableNumber Attribute
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } MatchResponseDetail } MatchCandidate } MatchQualityInformation } MatchBasis /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchGradeText string up to 11 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchGradeComponentCount int up to 2 digits., Optional

The total number of constituent parts (e.g., Name, Street Number) that were used in the calculation of the Match Grade.

GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchGradeComponent Aggregate, Optional (Array)
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchGradeComponent { MatchGradeComponentTypeText string up to 256 chars., Required

Possible values: Business Name; Street Number; Street Name; PO Box; City; State; Postal Code; Telephone Number; Uniqueness; Density; Industry

GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchGradeComponent { MatchGradeComponentTypeText @DNBCodeValue Attribute
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchGradeComponent { MatchGradeComponentTypeText @DNBCodeTableNumber Attribute
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchGradeComponent { MatchGradeComponentRating string up to 1 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchGradeComponent { MatchGradeComponentScore decimal up to 24 digits. Maximum of 11 decimal places., Optional
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } MatchResponseDetail } MatchCandidate } MatchQualityInformation } MatchGradeComponent /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchDataProfileText string up to 28 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchDataProfileComponentCount int up to 2 digits., Optional

The total number of constituent parts (e.g., Name, Street Number) that were used in the calculation of the Match Data Profile.

GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchDataProfileComponent Aggregate, Optional (Array)
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchDataProfileComponent { MatchDataProfileComponentTypeText string up to 256 chars., Required
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchDataProfileComponent { MatchDataProfileComponentTypeText @DNBCodeValue Attribute
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchDataProfileComponent { MatchDataProfileComponentTypeText @DNBCodeTableNumber Attribute
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { MatchQualityInformation { MatchDataProfileComponent { MatchDataProfileComponentValue string at least 2 chars. up to 2 chars., Required
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } MatchResponseDetail } MatchCandidate } MatchQualityInformation } MatchDataProfileComponent /Aggregate
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } MatchResponseDetail } MatchCandidate } MatchQualityInformation /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { MatchResponseDetail { MatchCandidate { DisplaySequence int up to 3 digits., Optional
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } MatchResponseDetail } MatchCandidate /Aggregate
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } MatchResponseDetail /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { CleanseAndStandardizeResponseDetail Aggregate, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { CleanseAndStandardizeResponseDetail { StandardizedName Aggregate, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { CleanseAndStandardizeResponseDetail { StandardizedName { OrganizationName string up to 256 chars., Required
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { CleanseAndStandardizeResponseDetail { StandardizedName { OrganizationName @LanguageCode Attribute
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { CleanseAndStandardizeResponseDetail { StandardizedName { OrganizationName @WritingScriptISOAlpha4Code Attribute
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } CleanseAndStandardizeResponseDetail } StandardizedName /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { CleanseAndStandardizeResponseDetail { StandardizedAddress Aggregate, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { CleanseAndStandardizeResponseDetail { StandardizedAddress { StreetAddressLine Aggregate, Optional (Array)
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { CleanseAndStandardizeResponseDetail { StandardizedAddress { StreetAddressLine { LineText string up to 240 chars., Required
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } CleanseAndStandardizeResponseDetail } StandardizedAddress } StreetAddressLine /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { CleanseAndStandardizeResponseDetail { StandardizedAddress { PrimaryTownName string up to 64 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { CleanseAndStandardizeResponseDetail { StandardizedAddress { CountyName string up to 64 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { CleanseAndStandardizeResponseDetail { StandardizedAddress { TerritoryAbbreviatedName string up to 64 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { CleanseAndStandardizeResponseDetail { StandardizedAddress { TerritoryName string up to 64 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { CleanseAndStandardizeResponseDetail { StandardizedAddress { PostalCode string up to 16 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { CleanseAndStandardizeResponseDetail { StandardizedAddress { PostalCodeExtensionCode string up to 16 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { CleanseAndStandardizeResponseDetail { StandardizedAddress { CountryISOAlpha2Code string at least 2 chars. up to 2 chars., Required
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { CleanseAndStandardizeResponseDetail { StandardizedAddress { CountryName string up to 64 chars., Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { CleanseAndStandardizeResponseDetail { StandardizedAddress { DeliveryPointValidationDetail Aggregate, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { CleanseAndStandardizeResponseDetail { StandardizedAddress { DeliveryPointValidationDetail { StatusValue DeliveryPointValidationStatusEnum up to 64 chars., Optional

Delivery Point Validated - 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. No DPV - Submitted address is invalid and possibly to definitely undeliverable. It might however, qualify for a ZIP+4. This is equal to DSF Deliverability Indicator #4 or higher or X. DPV STE Bad - Secondary address invalid: submitted street address is valid, but the submitted secondary address - the suite, room, floor or apartment # -- required for delivery at this location, is incorrect. This address is possibly deliverable, at the letter carrier's option. This is equal to DSF Deliverability Indicator #2. Missing STE - Secondary address missing: submitted street address is valid, but the secondary address - the suite, room, floor or apartment # -- required for delivery at this location, is missing. This address is possibly deliverable, at the letter carrier's option. Invalid Address - Submitted address is invalid, undeliverable and could not be identified by DPV. This is a fictitious address on the DPV file designed to identify mis-use of USPS data. Contact your DB rep. No DPV Address- DPV cannot categorize the input address.

GetCleanseMatchResponse { GetCleanseMatchResponseDetail { CleanseAndStandardizeResponseDetail { StandardizedAddress { DeliveryPointValidationDetail { CMRAValue DeliveryPointValidationCMRAEnum up to 64 chars., Optional

Delivery Point Validated - 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 another address with payment of new postage. (Example: “Mailboxes

End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } CleanseAndStandardizeResponseDetail } StandardizedAddress } DeliveryPointValidationDetail /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { CleanseAndStandardizeResponseDetail { StandardizedAddress { AddressTypeValue StandardizedAddressTypeEnum, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { CleanseAndStandardizeResponseDetail { StandardizedAddress { InexactAddressIndicator boolean, Optional
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } CleanseAndStandardizeResponseDetail } StandardizedAddress /Aggregate
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } CleanseAndStandardizeResponseDetail /Aggregate
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { InquiryReferenceDetail Aggregate, Optional
GetCleanseMatchResponse { GetCleanseMatchResponseDetail { InquiryReferenceDetail { CustomerReferenceText 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.

GetCleanseMatchResponse { GetCleanseMatchResponseDetail { InquiryReferenceDetail { 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.

End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail } InquiryReferenceDetail /Aggregate
End: GetCleanseMatchResponse } GetCleanseMatchResponseDetail /Aggregate
End: GetCleanseMatchResponse /Aggregate

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.

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 Code ISO Code for the country 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 Code The three digit code associated with the country 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 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.

Component Possible ValuesAdditional Details
Name00 to 44, 50, 60, 97-99 
Street Number00-03, 96, 98-99 
Street Name00-03, 96, 98-99 
City00-03, 96, 98-99Town Name
State00-03, 96, 98-99Territory Name (e.g. may be a Province for Canadian companies)
PO Box00, 02-03, 96, 98-99Post Office Box Number
Phone00, 02, 98-99Telephone Number
Postal Code00, 96, 98-99 
DUNS00, 98-99D-U-N-S Number
SIC00, 98-99Standard Industrial Classification
Density00, 98-99Defined as the number of businesses within the inquiry subject's postal region (e.g. within a given ZIP code for U.S. companies).
Uniqueness00, 98-99Defined as the number of unique matches for the inquiry subject name in the D&B database.
National ID00, 20, 98-99Organization Identification Number
URL00, 50, 60, 98-99Web Site Address

Business Name Component

The following table describes each of the possible MDP component values for the Name component.

Component ValueComponent Explanation
00Matched to the primary value for this field.

For example, if this is the Name component, this means it was successfully matched to the Primary Business Name.

01Matched to the registered value for this field. 4
02Matched to a Trade Style Name, a secondary or additional name used by the business.

A tradestyle is a name by which the business is known other than the formal, official name of the business. For example, D&B is a tradestyle of Dun & Bradstreet. 

03Matched to the CEO -- or other primary contact -- Name
04Matched to an additional executive name
05Matched to the former value of this field.
06Matched to the former tradestyle Name, which is an additional name used by the business other than the formal, official name of the business. 1
07Matched to the former CEO -- or other primary contact -- Name.
08Matched to a former executive name. 1
09Matched to a short name or abbreviated name for the business. 2
10Matched to a registered acronym, which is a word made from the first letters of syllables of other words, e.g. NATO is an acronym of North Atlantic Treaty Organization. 2

An acronym is usually pronounced as a word in its own right, as distinct from initialisms, which are pronounced as separate letters, e.g., BBC, CIA, FBI. initialisms are classed as tradestyles.

11Matched to a brand name, which is the name of a particular brand or product which is owned by the subject. 2

Examples might include: Coke, Snickers, Big Mac etc.

12Matched to the inquiry subject name, which is manually entered by operators to facilitate the finding of the company. 3

Sometimes it could be the previous name, other times it is just an acronym, part of name, or an abbreviation of name or extended name.

13Matched to a trademark name, which is a name, word, or symbol, especially (in full registered trademark) one that is officially registered and protected by law, used to represent a company or individual or product. 4

Trademarks often include the symbol ®, signifying that the mark has been registered. Trademarks tend to include precise formatting like the Coke or Ford logos, or more simply the hyphenated D-U-N-S Number Trademark.

14Matched to marketing name, which is a name assigned to the business for marketing purposes.4

Usually this will be a name created by D&B and not one which is officially used by the business.

15Matched to "known by name", which is any other name by which the entity is known that cannot be categorized by one of the other name types either because the name category is not covered by an existing type, or because the precise name type cannot be identified.4
16Matched to Stock Ticker Name.4
17Matched to Headquarter Business Name.4
18Matched to registered tradestyle name, which is the name which the business uses and by which it is known other than the formal, official name of the business.4

This code is only used for tradestyles which have been registered.

19Matched to the alternative language name, which is any of the names of the entity in a language other than the primary language of the entity.4

The primary language of the business is decided by the local country and is used in countries that have multiple languages.

20The inquiry Organization Identification Number matched completely to the candidate Organizational Identification Number.4

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.

21The inquiry Organization Identification Number matched only in part to the candidate Organizational Identification Number.4
30Matched to the Primary Business Name, but the legal designator (business type) of the candidate does not match the inquiry business type.
31Matched to the registered business name, but the legal designator (business type) of the candidate does not match the inquiry business type.4
32Matched to the current 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.
33Matched to the former business name, but the legal designator (business type) of the candidate does not match the inquiry business type.
34Matched to the former tradestyle name, but the legal designator (business type) of the candidate does not match the inquiry business type.1
35Matched to a short name or abbreviated name for the business, but the legal designator (business type) of the candidate does not match the inquiry business type.2
36Matched to a registered acronym, but the legal designator (business type) of the candidate does not match the inquiry business type.3
37Matched to a brand name, but the legal designator (business type) of the candidate does not match the inquiry business type.2
38Matched to the inquiry subject name, but the legal designator (business type) of the candidate does not match the inquiry business type.3
39Matched to a trademark name, but the legal designator (business type) of the candidate does not match the inquiry business type.4
40Matched to marketing name, but the legal designator (business type) of the candidate does not match the inquiry business type.4
41Matched to "known by name", but the legal designator (business type) of the candidate does not match the inquiry business type.4
42Matched to Headquarter Business Name, but the legal designator (business type) of the candidate does not match the inquiry business type.4
43Matched to registered tradestyle name, but the legal designator (business type) of the candidate does not match the inquiry business type.4

This code is only used for tradestyles which have been registered.

44Matched to the alternative language name, but the legal designator (business type) of the candidate does not match the inquiry business type.4
50Domain match done using the domain resolved from Input URL field
60Domain match done using the domain resolved from Input URL field

Physical Address Components

The following table describes each of the possible MDP component values for the Street Number, Street Name, City, and State components.

Component ValueComponent Explanation
00Matched to the primary value for this field.

For example, if this is the City component, this means it was successfully matched to the Town Name.

01Matched to the registered value for this field.4
02Matched to the former value of this field.
03Matched to the additional value of this field.

Mailing Address Component

The following table describes each of the possible MDP component values for the PO Box component.

Component ValueComponent Explanation
00Matched to the primary value for this field.

For example, if this is the PO Box component, this means it was successfully matched to the Post Office Box Number.

02Matched to the former value of this field.
03Matched to the additional value of this field.

Telephone Number Component

The following table describes each of the possible MDP component values for the Phone component.

Component ValueComponent Explanation
00Matched to the primary value for this field.

For example, if this is the Phone component, this means it was successfully matched to the Telephone Number.

02Matched to the former value of this field.

All Other Components

The following table describes each of the possible MDP component values for the Postal Code, DUNS, SIC, Density, Uniqueness, Organizational Identification Number and URL components.

Component ValueComponent Explanation
00Matched to the primary value for this field.

For example, if this is the Postal Code component, this means it was successfully matched to the Postal Code.

20The inquiry Organization Identification Number matched completely to the candidate Organizational Identification Number.4

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.

For example, if this is the National ID component, this means it was successfully matched to the Organization Identification Number.

50

Domain match done using the domain resolved from Input URL field

For example, if this is the URL component, this means it was successfully matched to the Web Site Address of URLText

60

Domain match done using the domain resolved from Input URL field

For example, if this is the URL component, this means it was successfully matched to the Web Site Address of URLText

Special Cases

The following table describes several additional possible MDP component values that apply to scenarios where a match was not possible.

Component ValueComponent Explanation
96Identifies when the inquiry record provided an address element which could not be verified or standardized by our standardization process.

This is applicable for the following inquiry components: Street Number, Street Name, PO Box, City, State and Postal Code.

97Identifies when there is no D&B designation for type of name matched.

This is applicable only for the Name component.

98Identifies when the matched D&B record lacked a particular element.

This is applicable for all components.

99Identifies when the inquiry record lacked a particular element.

This is applicable for all components.

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