FindCompanyCleanseMatch

Find Company Cleanse Match

Overview

The Cleanse Match Service acts as an interface for matching a name and address of a business. The response typically consists of response candidates that are identified as the best matches for the input criteria based on D&Bs match algorithms.

Input Parameters

Field Name Value Notes
PrimaryName Company Name
Address Address
City City
State State Mandatory for US
PostCode Postal Code
Country Country Code The country code will always be ISO.
Phone Phone Number
ConfidenceCode Confidence Code

Output Parameters

Field Name Value Notes
TranID TransactionID Unique Identifier of the transaction
CandidatesReturned Candidates Returned
Code Status Code Response status code that describes whether a successful response is returned or an error is returned.
Description Status Description Description of the status code
ConfidenceCode
MatchGradeString
MatchBasisCode Match Basis
DUNS
PrimaryBusinessName
PhysicalAddressLine
PhysicalCity
PhysicalState
PhysicalPostalCode
CountryCode
CountryName

Input XML

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sch="http://applications.dnb.com/webservice/schema/">
   <soapenv:Header>
      <sch:password>YOUR-PASSWORD-HERE</sch:password>
      <sch:username>YOUR-USERNAME-HERE</sch:username>
      <sch:API-KEY>YOUR-API-KEY-HERE</sch:API-KEY>
   </soapenv:Header>
   <soapenv:Body>
      <sch:FindCompanyCleanseMatchRequest>
         <sch:DataAreaRequest>
            <sch:OrderRequest>
               <sch:PrimaryName>dun & bradstreet</sch:PrimaryName>
               <sch:Address>103 jfk parkway</sch:Address>
               <sch:City>short hills</sch:City>
               <sch:State>nj</sch:State>
               <sch:PostalCode>07078</sch:PostalCode>
               <sch:Country>US</sch:Country><sch:ConfidenceCode>9</sch:ConfidenceCode>
            </sch:OrderRequest>
         </sch:DataAreaRequest>
      </sch:FindCompanyCleanseMatchRequest>
   </soapenv:Body>
</soapenv:Envelope>

Output XML

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <SOAP-ENV:Body>
      <sch:FindCompanyCleanseMatchResponse xmlns:sch="http://applications.dnb.com/webservice/schema/">
         <sch:DataAreaResponse>
            <sch:OrderResponseHeader>
               <sch:TranID>73BCC862-F2CB-4B01-B6A0-812A095E0A4F</sch:TranID>
               <sch:Status>
                  <sch:Code>1</sch:Code>
                  <sch:Description>Success - good call</sch:Description>
               </sch:Status>
            </sch:OrderResponseHeader>
            <sch:OrderResponse>
               <sch:CandidatesReturned>12</sch:CandidatesReturned>
               <sch:Candidates>
                  <sch:Candidate>
                     <sch:DUNS>884114609</sch:DUNS>
                     <sch:ConfidenceCode>10</sch:ConfidenceCode>
                     <sch:BestMatchFlag>true</sch:BestMatchFlag>
                     <sch:MatchGradeString>AAAAAZZAFFZ</sch:MatchGradeString>
                     <sch:PrimaryBusinessName>DUN & BRADSTREET CORPORATION, THE</sch:PrimaryBusinessName>
                     <sch:PhysicalAddressLine>103 JFK PARKWAY</sch:PhysicalAddressLine>
                     <sch:PhysicalCity>SHORT HILLS</sch:PhysicalCity>
                     <sch:PhysicalState>NJ</sch:PhysicalState>
                     <sch:PhysicalPostalCode>07078</sch:PhysicalPostalCode>
                     <sch:CountryCode>US</sch:CountryCode>
                     <sch:CountryName>UNITED STATES OF AMERICA</sch:CountryName>
                     <sch:Phone>9739215500</sch:Phone>
                     <sch:SubjectDetails>ParentHeadquarters</sch:SubjectDetails>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>11801100</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>118011140</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MDPProfile>0000000000989800000000009898</sch:MDPProfile>
                  </sch:Candidate>
                  <sch:Candidate>
                     <sch:DUNS>150483782</sch:DUNS>
                     <sch:ConfidenceCode>10</sch:ConfidenceCode>
                     <sch:MatchGradeString>AAAAAZZAFFZ</sch:MatchGradeString>
                     <sch:PrimaryBusinessName>DUN & BRADSTREET, INC.</sch:PrimaryBusinessName>
                     <sch:PhysicalAddressLine>103 JFK PARKWAY</sch:PhysicalAddressLine>
                     <sch:PhysicalCity>SHORT HILLS</sch:PhysicalCity>
                     <sch:PhysicalState>NJ</sch:PhysicalState>
                     <sch:PhysicalPostalCode>07078</sch:PhysicalPostalCode>
                     <sch:CountryCode>US</sch:CountryCode>
                     <sch:CountryName>UNITED STATES OF AMERICA</sch:CountryName>
                     <sch:Phone>9739215500</sch:Phone>
                     <sch:SubjectDetails>ParentHeadquarters</sch:SubjectDetails>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>11801100</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>118011140</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MDPProfile>0000000000989800000000009898</sch:MDPProfile>
                  </sch:Candidate>
                  <sch:Candidate>
                     <sch:DUNS>049977515</sch:DUNS>
                     <sch:ConfidenceCode>10</sch:ConfidenceCode>
                     <sch:MatchGradeString>AAAAAZZAFFZ</sch:MatchGradeString>
                     <sch:PrimaryBusinessName>DUN & BRADSTREET INTERNATIONAL, LTD.</sch:PrimaryBusinessName>
                     <sch:PhysicalAddressLine>103 JFK PARKWAY</sch:PhysicalAddressLine>
                     <sch:PhysicalCity>SHORT HILLS</sch:PhysicalCity>
                     <sch:PhysicalState>NJ</sch:PhysicalState>
                     <sch:PhysicalPostalCode>07078</sch:PhysicalPostalCode>
                     <sch:CountryCode>US</sch:CountryCode>
                     <sch:CountryName>UNITED STATES OF AMERICA</sch:CountryName>
                     <sch:Phone>9739215500</sch:Phone>
                     <sch:TradeStyle>DUN & BRADSTREET</sch:TradeStyle>
                     <sch:SubjectDetails>ParentHeadquarters</sch:SubjectDetails>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>11801090</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>118011140</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MDPProfile>0200000000989800000000009898</sch:MDPProfile>
                  </sch:Candidate>
                  <sch:Candidate>
                     <sch:DUNS>825216229</sch:DUNS>
                     <sch:ConfidenceCode>10</sch:ConfidenceCode>
                     <sch:MatchGradeString>AAAAAZZAFFZ</sch:MatchGradeString>
                     <sch:PrimaryBusinessName>DUN & BRADSTREET HOLDINGS-FRANCE, INC.</sch:PrimaryBusinessName>
                     <sch:PhysicalAddressLine>103 JFK PARKWAY</sch:PhysicalAddressLine>
                     <sch:PhysicalCity>SHORT HILLS</sch:PhysicalCity>
                     <sch:PhysicalState>NJ</sch:PhysicalState>
                     <sch:PhysicalPostalCode>07078</sch:PhysicalPostalCode>
                     <sch:CountryCode>US</sch:CountryCode>
                     <sch:CountryName>UNITED STATES OF AMERICA</sch:CountryName>
                     <sch:Phone>9739215500</sch:Phone>
                     <sch:TradeStyle>DUN & BRADSTREET</sch:TradeStyle>
                     <sch:SubjectDetails>ParentHeadquarters</sch:SubjectDetails>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>11801090</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>118011140</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MDPProfile>0200000000989800000000009898</sch:MDPProfile>
                  </sch:Candidate>
                  <sch:Candidate>
                     <sch:DUNS>158134655</sch:DUNS>
                     <sch:ConfidenceCode>10</sch:ConfidenceCode>
                     <sch:MatchGradeString>AAAAAZZAFFZ</sch:MatchGradeString>
                     <sch:PrimaryBusinessName>DUN & BRADSTREET VENTURES, INC.</sch:PrimaryBusinessName>
                     <sch:PhysicalAddressLine>103 JFK PARKWAY</sch:PhysicalAddressLine>
                     <sch:PhysicalCity>SHORT HILLS</sch:PhysicalCity>
                     <sch:PhysicalState>NJ</sch:PhysicalState>
                     <sch:PhysicalPostalCode>07078</sch:PhysicalPostalCode>
                     <sch:CountryCode>US</sch:CountryCode>
                     <sch:CountryName>UNITED STATES OF AMERICA</sch:CountryName>
                     <sch:Phone>9739215500</sch:Phone>
                     <sch:TradeStyle>DUN & BRADSTREET</sch:TradeStyle>
                     <sch:SubjectDetails>SingleLocation</sch:SubjectDetails>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>11801090</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>118011140</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MDPProfile>0200000000989800000000009898</sch:MDPProfile>
                  </sch:Candidate>
                  <sch:Candidate>
                     <sch:DUNS>004244377</sch:DUNS>
                     <sch:ConfidenceCode>10</sch:ConfidenceCode>
                     <sch:MatchGradeString>AAAAAZZAFFZ</sch:MatchGradeString>
                     <sch:PrimaryBusinessName>DUN & BRADSTREET DEUTSCHLAND GMBH</sch:PrimaryBusinessName>
                     <sch:PhysicalAddressLine>103 JFK PARKWAY</sch:PhysicalAddressLine>
                     <sch:PhysicalCity>SHORT HILLS</sch:PhysicalCity>
                     <sch:PhysicalState>NJ</sch:PhysicalState>
                     <sch:PhysicalPostalCode>07078</sch:PhysicalPostalCode>
                     <sch:CountryCode>US</sch:CountryCode>
                     <sch:CountryName>UNITED STATES OF AMERICA</sch:CountryName>
                     <sch:Phone>9739215500</sch:Phone>
                     <sch:TradeStyle>DUN & BRADSTREET</sch:TradeStyle>
                     <sch:SubjectDetails>SingleLocation</sch:SubjectDetails>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>11801090</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>118011140</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MDPProfile>0200000000989800000000009898</sch:MDPProfile>
                  </sch:Candidate>
                  <sch:Candidate>
                     <sch:DUNS>158807698</sch:DUNS>
                     <sch:ConfidenceCode>10</sch:ConfidenceCode>
                     <sch:MatchGradeString>AAAAAZZAFFZ</sch:MatchGradeString>
                     <sch:PrimaryBusinessName>DUN & BRADSTREET EUROPE, LTD.</sch:PrimaryBusinessName>
                     <sch:PhysicalAddressLine>103 JFK PARKWAY</sch:PhysicalAddressLine>
                     <sch:PhysicalCity>SHORT HILLS</sch:PhysicalCity>
                     <sch:PhysicalState>NJ</sch:PhysicalState>
                     <sch:PhysicalPostalCode>07078</sch:PhysicalPostalCode>
                     <sch:CountryCode>US</sch:CountryCode>
                     <sch:CountryName>UNITED STATES OF AMERICA</sch:CountryName>
                     <sch:Phone>9739215500</sch:Phone>
                     <sch:TradeStyle>DUN & BRADSTREET</sch:TradeStyle>
                     <sch:SubjectDetails>SingleLocation</sch:SubjectDetails>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>11801090</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>118011140</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MDPProfile>0200000000989800000000009898</sch:MDPProfile>
                  </sch:Candidate>
                  <sch:Candidate>
                     <sch:DUNS>158808316</sch:DUNS>
                     <sch:ConfidenceCode>10</sch:ConfidenceCode>
                     <sch:MatchGradeString>AAAAAZZAFFZ</sch:MatchGradeString>
                     <sch:PrimaryBusinessName>DUN & BRADSTREET CREDIT CONTROL, LTD.</sch:PrimaryBusinessName>
                     <sch:PhysicalAddressLine>103 JFK PARKWAY</sch:PhysicalAddressLine>
                     <sch:PhysicalCity>SHORT HILLS</sch:PhysicalCity>
                     <sch:PhysicalState>NJ</sch:PhysicalState>
                     <sch:PhysicalPostalCode>07078</sch:PhysicalPostalCode>
                     <sch:CountryCode>US</sch:CountryCode>
                     <sch:CountryName>UNITED STATES OF AMERICA</sch:CountryName>
                     <sch:Phone>9739215500</sch:Phone>
                     <sch:TradeStyle>DUN & BRADSTREET</sch:TradeStyle>
                     <sch:SubjectDetails>SingleLocation</sch:SubjectDetails>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>11801090</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>118011140</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MDPProfile>0200000000989800000000009898</sch:MDPProfile>
                  </sch:Candidate>
                  <sch:Candidate>
                     <sch:DUNS>004249319</sch:DUNS>
                     <sch:ConfidenceCode>10</sch:ConfidenceCode>
                     <sch:MatchGradeString>AAAAAZZAFFZ</sch:MatchGradeString>
                     <sch:PrimaryBusinessName>DUN & BRADSTREET BELGIUM NV</sch:PrimaryBusinessName>
                     <sch:PhysicalAddressLine>103 JFK PARKWAY</sch:PhysicalAddressLine>
                     <sch:PhysicalCity>SHORT HILLS</sch:PhysicalCity>
                     <sch:PhysicalState>NJ</sch:PhysicalState>
                     <sch:PhysicalPostalCode>07078</sch:PhysicalPostalCode>
                     <sch:CountryCode>US</sch:CountryCode>
                     <sch:CountryName>UNITED STATES OF AMERICA</sch:CountryName>
                     <sch:Phone>9739215500</sch:Phone>
                     <sch:TradeStyle>DUN & BRADSTREET</sch:TradeStyle>
                     <sch:SubjectDetails>SingleLocation</sch:SubjectDetails>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>11801090</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>118011140</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MDPProfile>0200000000989800000000009898</sch:MDPProfile>
                  </sch:Candidate>
                  <sch:Candidate>
                     <sch:DUNS>158135918</sch:DUNS>
                     <sch:ConfidenceCode>10</sch:ConfidenceCode>
                     <sch:MatchGradeString>AAAAAZZAFFZ</sch:MatchGradeString>
                     <sch:PrimaryBusinessName>DUNS INVESTING VIII CORPORATION</sch:PrimaryBusinessName>
                     <sch:PhysicalAddressLine>103 JFK PARKWAY</sch:PhysicalAddressLine>
                     <sch:PhysicalCity>SHORT HILLS</sch:PhysicalCity>
                     <sch:PhysicalState>NJ</sch:PhysicalState>
                     <sch:PhysicalPostalCode>07078</sch:PhysicalPostalCode>
                     <sch:CountryCode>US</sch:CountryCode>
                     <sch:CountryName>UNITED STATES OF AMERICA</sch:CountryName>
                     <sch:Phone>9739215500</sch:Phone>
                     <sch:TradeStyle>DUN & BRADSTREET</sch:TradeStyle>
                     <sch:SubjectDetails>SingleLocation</sch:SubjectDetails>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>11801090</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>118011140</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MDPProfile>0200000000989800000000009898</sch:MDPProfile>
                  </sch:Candidate>
                  <sch:Candidate>
                     <sch:DUNS>825211964</sch:DUNS>
                     <sch:ConfidenceCode>10</sch:ConfidenceCode>
                     <sch:MatchGradeString>AAAAAZZAFFZ</sch:MatchGradeString>
                     <sch:PrimaryBusinessName>DUN & BRADSTREET COMPUTER LEASING, INC.</sch:PrimaryBusinessName>
                     <sch:PhysicalAddressLine>103 JFK PARKWAY</sch:PhysicalAddressLine>
                     <sch:PhysicalCity>SHORT HILLS</sch:PhysicalCity>
                     <sch:PhysicalState>NJ</sch:PhysicalState>
                     <sch:PhysicalPostalCode>07078</sch:PhysicalPostalCode>
                     <sch:CountryCode>US</sch:CountryCode>
                     <sch:CountryName>UNITED STATES OF AMERICA</sch:CountryName>
                     <sch:Phone>9739215500</sch:Phone>
                     <sch:TradeStyle>DUN & BRADSTREET</sch:TradeStyle>
                     <sch:SubjectDetails>SingleLocation</sch:SubjectDetails>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>11801090</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>118011140</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MDPProfile>0200000000989800000000009898</sch:MDPProfile>
                  </sch:Candidate>
                  <sch:Candidate>
                     <sch:DUNS>825216195</sch:DUNS>
                     <sch:ConfidenceCode>10</sch:ConfidenceCode>
                     <sch:MatchGradeString>AAAAAZZAFFZ</sch:MatchGradeString>
                     <sch:PrimaryBusinessName>DUN & BRADSTREET SOFTWARE SERVICES INTERNATIONAL, INC.</sch:PrimaryBusinessName>
                     <sch:PhysicalAddressLine>103 JFK PARKWAY</sch:PhysicalAddressLine>
                     <sch:PhysicalCity>SHORT HILLS</sch:PhysicalCity>
                     <sch:PhysicalState>NJ</sch:PhysicalState>
                     <sch:PhysicalPostalCode>07078</sch:PhysicalPostalCode>
                     <sch:CountryCode>US</sch:CountryCode>
                     <sch:CountryName>UNITED STATES OF AMERICA</sch:CountryName>
                     <sch:Phone>9739215500</sch:Phone>
                     <sch:TradeStyle>DUN & BRADSTREET</sch:TradeStyle>
                     <sch:SubjectDetails>SingleLocation</sch:SubjectDetails>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>11801090</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MatchBasis>
                        <sch:MatchBasisCode>118011140</sch:MatchBasisCode>
                     </sch:MatchBasis>
                     <sch:MDPProfile>0200000000989800000000009898</sch:MDPProfile>
                  </sch:Candidate>
               </sch:Candidates>
            </sch:OrderResponse>
         </sch:DataAreaResponse>
      </sch:FindCompanyCleanseMatchResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>