Advanced Company Search

Overview

Returns search result of companies based on various criteria. Formerly known as the Build A List (BAL) Service. Please note that, the maximum number of records that can be pulled is 200 per call with a total maximum of 10,000.

Input Parameters

Field Name Value Notes
\bal\maxrecords Max Records Between 1-200. Default = 20
\bal\hitOffset Greater than or equal to 0 but less than or equal to 10,000. Default = 0 Paging support, the firstHit returned will be hitOffset + 1. hitOffset is now zero-based.
\bal\sortdirection Sort Direction Values defined in WSDL: sortDirectionTypes - ascending or descending
\bal\orderby Order By Values defined in WSDL: orderByTypes
\bal\companySize\employeesFrom Total Employees Lower Bound
\bal\companySize\employeesTo Total Employees Upper Bound
\bal\companySize\employeesGrowthFrom Total Employees Growth Percentage Lower Bound
\bal\companySize\employeesGrowthTo Total Employees Growth Percentage Upper Bound
\bal\companySize\employeesThisLocationFrom Employees at this Location Lower Bound
\bal\companySize\employeesThisLocationTo Employees at this Location Upper Bound
\bal\companySize\marketCapFrom Market Cap ($ mil) Lower Bound
\bal\companySize\marketCapTo Market Cap ($ mil) Upper Bound
\bal\companySize\salesFrom Annual Sales ($ mil) Lower Bound
\bal\companySize\salesTo Annual Sales ($ mil) Upper Bound
\bal\companySize\salesGrowthFrom Annual Sales Growth (%) Lower Bound
\bal\companySize\salesGrowthTo Annual Sales Growth (%) Upper Bound
\bal\companyType\locationType Location Type ID Value from GetAdvancedSearchLookups
\bal\companyType\ownershipType Values are 1 (Public), 21 (Owned by a Public Company) or 0 (Non-Public)
\bal\companyType\subsidiaryStatus Subsidiary Status Subsidiary or Not a Subsidiary
\bal\companyType\franchiseStatus Franchise Status Values are for searching Franchise (true) and Not a Franchise (false)
\bal\financialdata\advertisingExpenseFrom Ad Expense ($ mil) Lower Bound.
\bal\financialdata\advertisingExpenseTo Ad Expense ($ mil) Upper Bound.
\bal\financialdata\assetsFrom Assets ($ mil) Lower Bound.
\bal\financialdata\assetsTo Assets ($ mil) Upper Bound.
\bal\financialdata\filingDateFrom Filing Date Lower Bound YYYY-MM-DD
\bal\financialdata\filingDateTo Filing Date Upper Bound YYYY-MM-DD
\bal\financialdata\fiscalYearEnd Fiscal Year End Month
\bal\financialdata\incomeFrom Net Income ($ mil) Lower Bound.
\bal\financialdata\incomeGrowthFrom Net Income Growth (%) Lower Bound
\bal\financialdata\incomeGrowthTo Net Income Growth (%) Upper Bound
\bal\financialdata\incomeTo Net Income ($ mil) Upper Bound
\bal\financialdata\offerFrom US IPO Data - Offer Amount ($ mil.) Lower Bound
\bal\financialdata\offerTo US IPO Data - Offer Amount ($ mil.) Upper Bound
\bal\financialdata\priceRangeFrom US IPO Data - Price Range ($) Lower Bound
\bal\financialdata\priceRangeTo US IPO Data - Price Range ($) Upper Bound
\bal\financialdata\researchExpenseFrom R&D Expense ($ mil) Lower Bound
\bal\financialdata\researchExpenseTo R&D Expense ($ mil) Upper Bound
\bal\financialdata\tradingDateFrom Trading Date Lower Bound YYYY-MM-DD
\bal\financialdata\tradingDateTo Trading Date Upper Bound YYYY-MM-DD
\bal\financialdata\underwriterId Underwriters ID Value from GetAdvancedSearchLookups It searches only the lead underwriter for the given underwriterId.
\bal\financialdata\marketingPreScreenScore Marketing pre-screen scores Enumerated values of 'L' indicating low, 'M' indicating medium, or 'H' indicating high are accepted. Allows for unique combinations of the preceding values from 0 to 3 times.
\bal\industry\dnbIndustryCode Industry Name ID Value from GetAdvancedSearchLookups
\bal\industry\primaryOnly Primary Industry Only Boolean
\bal\industry\nAICS NAICS Code Enter only one code per element. Use multiple elements for multiple codes. Enter at least two digits per code. No CSV or Ranges can be specified.
\bal\industry\nAICSRange\[from|to] NAICS Code Ranges Enter one or more range elements. Each range element must contain 'from' and a 'to' element.
\bal\industry\uSSIC US SIC Code Enter only one code per element. Use multiple elements for multiple codes. Enter at least two digits per code. No CSV or Ranges can be specified
\bal\industry\uSSICRange\[from|to] SIC Code Ranges Enter one or more range elements. Each range element must contain 'from' and a 'to' element.
\bal\industry\uKSIC UK SIC Code Enter only one code per element. Use multiple elements for multiple codes. Enter at least two digits per code. No CSV or Ranges can be specified
\bal\industry\uKSICRange\[from|to] UKSIC Code Ranges Enter one or more range elements. Each range element must contain 'from' and a 'to' element.
\bal\location\areacode US/Canada Area Code e.g. 512 or 210. To search with multiple area codes, create multiple area code elements one beneath another.
\bal\location\streetAddress Street Address e.g. 1700 Pennsylvania Ave
\bal\location\county Wrapper for county type Searching by multiple counties is allowed. Send in multiple county wrapper elements.
\bal\location\county\countyId County ID ID Value from GetAdvancedSearchLookups
\bal\location\county\state State ID Value from GetAdvancedSearchLookups
\bal\location\county\countryId Country ID ID Value from GetAdvancedSearchLookups
\bal\location\city City e.g. Madrid or New York (single city only)
\bal\location\countryId Country ID Value from GetAdvancedSearchLookups
\bal\location\globalState Global State/Province e.g Queensland or NY (single province/state only)
\bal\location\metropolitanId US Metropolitan Area ID Value from GetAdvancedSearchLookups
\bal\location\regionId World Region ID Value from GetAdvancedSearchLookups
\bal\location\usStateCanadaProvince US State/Canada Province
\bal\location\postalCode Postal Code e.g. 78701 or "SW1P 1JA" or "SW1". To search with multiple codes, create multiple Postal code elements one beneath another.
\bal\location\usZipCodeRange\from US ZIP Code Lower Bound
\bal\location\usZipCodeRange\to US ZIP Code Upper Bound
\bal\location\zipAreaSearch\scale Units to search in: miles or kilometers e.g. Find results within 50 miles of 78745 (up to a maximum radius of 100 miles or 160 km). Use only one 5-digit ZIP code. Requires zipareawithin and zipareazipcode.
\bal\location\zipAreaSearch\radius # of miles or kilometers to search within. e.g. Find results within 50 miles of 78745 (up to a maximum radius of 100 miles or 160 km). Use only one 5-digit ZIP code. Requires zipareawithin and zipareazipcode.
\bal\location\zipAreaSearch\zipCode Zipcode to search within (78745 in the example). e.g. Find results within 50 miles of 78745 (up to a maximum radius of 100 miles or 160 km). Use only one 5-digit ZIP code. Requires zipareawithin and zipareazipcode.
\bal\location\latLongSearch\scale Units to search in: miles or kilometers Requires radius, latitude, and longitude.
\bal\location\latLongSearch\radius # of miles or kilometers to search within Requires scale, latitude, and longitude.
\bal\location\latLongSearch\latitude latitude Requires scale, radius, and longitude.
\bal\location\latLongSearch\longitude longitude Requires scale, radius, and latitude.
\bal\location\allAny All or Any Matches on Location Criteria Matching ALL means a company would have to match each type of criteria entered. Matching ANY means that a company could match any single type of criteria entered. Valid values All or Any
\bal\location\ukCounty UK County A valid UK County name
\bal\specialtyCriteria\auditorId Auditors ID Value from GetAdvancedSearchLookups
\bal\specialtyCriteria\companyKeyword Company Keyword e.g. laptops or China or acquired, merged, takeover
\bal\specialtyCriteria\duns DUNS Number
\bal\specialtyCriteria\exchangeId Exchange ID Value from GetAdvancedSearchLookups
\bal\specialtyCriteria\rankingId Rankings/Indices ID Value from GetAdvancedSearchLookups
\bal\specialtyCriteria\ukRegistration UK Registration Number e.g. 3443456. Use multiple elements for multiple UK Registration values
\bal\specialtyCriteria\ukVat UK Vat Number e.g. 906565610. Use multiple elements for multiple UK VAT values
\bal\specialtyCriteria\yearFoundingFrom Year of Founding or Change in Control Lower Bound YYYY
\bal\specialtyCriteria\yearFoundingTo Year of Founding or Change in Control (YYYY) Upper Bound YYYY
\bal\specialtyCriteria\ultimateParentDuns The ultimate parent DUNS number for a family of companies eg. 060902413 or 884364530
\bal\specialtyCriteria\primaryUrl Primary URL
\bal\specialtyCriteria\companyName Company Name
\bal\specialtyCriteria\minorityOwned Minority Owned Company Boolean
\bal\specialtyCriteria\womenOwned Women Owned Company Boolean
\bal\specialtyCriteria\squareFootageFrom Company square foot range from
\bal\specialtyCriteria\squareFootRangeTo Company square foot range to
\bal\specialtyCriteria\ethnicity Ethnicity of the company owner Values defined in WSDL - Ethnicity enumeration
\bal\specialtyCriteria\legalStatus Legal Status of the company Values defined in WSDL - Legal Status enumeration
\bal\specialtyCriteria\ownedOrRented Company resides in Owned or Rented Space Values defined in WSDL - OwnsOrRent enumeration

Output Parameters

Field Name Value Notes
\return\companies\firstHit First Hit
\return\companies\hits Total Number of Hits in this Response
\return\companies\lastHit Last Hit
\return\companies\totalHits Aggregate Total Number of Hits This is the total number of results the search returned.
\return\companies\hit\hitNumber Hit Number
\return\companies\hit\companyResults Company Results
\return\companies\hit\companyResults\companyId Company ID
\return\companies\hit\companyResults\duns DUNS Number
\return\companies\hit\companyResults\companyName Company Name
\return\companies\hit\companyResults\nonMarketableCompany NonMarketable Company Enum of reason returned. Example out of business
\return\companies\hit\companyResults\locationType Location type such as Headquarters or branch
\return\resultSet\hit\companyResults\address1 Street Address
\return\companies\hit\companyResults\city Address City
\return\companies\hit\companyResults\country Address Country
\return\companies\hit\companyResults\countryId Address Country ID
\return\companies\hit\companyResults\stateOrProvince Address State/Province ID Value from GetAdvancedSearchLookups
\return\companies\hit\companyResults\postalCode Postal Code
\return\companies\hit\companyResults\primaryUrl Primary URL
\return\companies\hit\companyResults\parentDuns Parent Company DUNS Number
\return\companies\hit\companyResults\ultimateParentDunsNumber Ultimate Parent Company DUNS Number
\return\companies\hit\companyResults\sales Annual Sales
\return\companies\hit\companyResults\hqPhone Headquarters Phone Number
\return\companies\hit\companyResults\doNotCallRegistry Indicates whether company is listed on a UK Do Not Call registry
\return\companies\hit\companyResults\dbas List of DBA names
\return\companies\hit\companyResults\dbas\dba Doing Business As Company Name
\return\companies\hit\companyResults\historicalIndicator Indicates that the company has ceased operations Value of 'true' indicates that the company has ceased operations

Input XML

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sch="http://applications.dnb.com/webservice/schema/">
   <soapenv:Header>
      <sch:API-KEY>YOUR-API-KEY-HERE</sch:API-KEY>
   </soapenv:Header>
   <soapenv:Body>
   <sch:AdvancedCompanySearchRequest>
         <sch:bal>
            <sch:maxRecords>3</sch:maxRecords>
            <sch:hitOffset>0</sch:hitOffset>
            <sch:sortDirection>Ascending</sch:sortDirection>          
            <sch:location>
               <sch:usZipCodeRange>
                  <sch:from>78705</sch:from>
                  <sch:to>98567</sch:to>
               </sch:usZipCodeRange>
	    </sch:location>
         </sch:bal>
      </sch:AdvancedCompanySearchRequest>
   </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:AdvancedCompanySearchResponse xmlns:sch="http://applications.dnb.com/webservice/schema/">
         <sch:return>
            <sch:companies>
               <sch:firstHit>1</sch:firstHit>
               <sch:hits>3</sch:hits>
               <sch:lastHit>3</sch:lastHit>
               <sch:totalHits>5169308</sch:totalHits>
               <sch:hit>
                  <sch:hitNumber>1</sch:hitNumber>
                  <sch:companyResults>
                     <sch:companyId>10723000000000</sch:companyId>
                     <sch:duns>9122532</sch:duns>
                     <sch:companyName>Hewlett-Packard Company</sch:companyName>
                     <sch:locationType>Headquarters</sch:locationType>
                     <sch:address1>3000 Hanover St.</sch:address1>
                     <sch:city>Palo Alto</sch:city>
                     <sch:country>United States</sch:country>
                     <sch:countryId>76</sch:countryId>
                     <sch:stateOrProvince>CA</sch:stateOrProvince>
                     <sch:primaryUrl>http://www.hp.com</sch:primaryUrl>
                     <sch:parentDuns>9122532</sch:parentDuns>
                     <sch:ultimateParentDuns>9122532</sch:ultimateParentDuns>
                     <sch:sales>126033.0</sch:sales>
                     <sch:hqPhone>650-857-1501</sch:hqPhone>
                     <sch:doNotCallRegistry>false</sch:doNotCallRegistry>
                     <sch:dbas>
                        <sch:dba>COMPAQ COMPUTER</sch:dba>
                        <sch:dba>HP</sch:dba>
                     </sch:dbas>
                     <sch:historicalIndicator>false</sch:historicalIndicator>
                  </sch:companyResults>
               </sch:hit>
               <sch:hit>
                  <sch:hitNumber>2</sch:hitNumber>
                  <sch:companyResults>
                     <sch:companyId>58450000000000</sch:companyId>
                     <sch:duns>6962435</sch:duns>
                     <sch:companyName>Wells Fargo & Company</sch:companyName>
                     <sch:locationType>Headquarters</sch:locationType>
                     <sch:address1>420 Montgomery St.</sch:address1>
                     <sch:city>San Francisco</sch:city>
                     <sch:country>United States</sch:country>
                     <sch:countryId>76</sch:countryId>
                     <sch:stateOrProvince>CA</sch:stateOrProvince>
                     <sch:primaryUrl>http://www.wellsfargo.com</sch:primaryUrl>
                     <sch:parentDuns>6962435</sch:parentDuns>
                     <sch:ultimateParentDuns>6962435</sch:ultimateParentDuns>
                     <sch:sales>93249.0</sch:sales>
                     <sch:hqPhone>866-878-5865</sch:hqPhone>
                     <sch:doNotCallRegistry>false</sch:doNotCallRegistry>
                     <sch:dbas>
                        <sch:dba>Wells Fargo</sch:dba>
                     </sch:dbas>
                     <sch:historicalIndicator>false</sch:historicalIndicator>
                  </sch:companyResults>
               </sch:hit>
               <sch:hit>
                  <sch:hitNumber>3</sch:hitNumber>
                  <sch:companyResults>
                     <sch:companyId>14120000000000</sch:companyId>
                     <sch:duns>81466849</sch:duns>
                     <sch:companyName>Microsoft Corporation</sch:companyName>
                     <sch:locationType>Headquarters</sch:locationType>
                     <sch:address1>1 Microsoft Way</sch:address1>
                     <sch:city>Redmond</sch:city>
                     <sch:country>United States</sch:country>
                     <sch:countryId>76</sch:countryId>
                     <sch:stateOrProvince>WA</sch:stateOrProvince>
                     <sch:primaryUrl>http://www.microsoft.com</sch:primaryUrl>
                     <sch:parentDuns>81466849</sch:parentDuns>
                     <sch:ultimateParentDuns>81466849</sch:ultimateParentDuns>
                     <sch:sales>69943.0</sch:sales>
                     <sch:hqPhone>425-882-8080</sch:hqPhone>
                     <sch:doNotCallRegistry>false</sch:doNotCallRegistry>
                     <sch:dbas>
                        <sch:dba>Microsoft</sch:dba>
                     </sch:dbas>
                     <sch:historicalIndicator>false</sch:historicalIndicator>
                  </sch:companyResults>
               </sch:hit>
            </sch:companies>
         </sch:return>
      </sch:AdvancedCompanySearchResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

 

Get Company Detail Optional Data

Overview

Returns detailed company information for a single company based on criteria of a DUNS or a Company ID. Either DUNS or Company ID are allowed.

Input Parameters

Field Name Value Notes
\optionalResponseFields\includeKeyNumbers Flag that determines whether to include the key numbers data
\optionalResponseFields\includeIndustries Flag that determines whether to include the industries data
\optionalResponseFields\includeURLs Flag that determines whether to include the url data
\optionalResponseFields\includeRankings Flag that determines whether to include the rankings data
\optionalResponseFields\includePhones Flag that determines whether to include the phones data
\optionalResponseFields\includeSocialMedia Type of social media data to include for the company Options: all, twitter, facebook, youtube, wikipedia
\optionalResponseFields\includeLocations Flag that determines whether to include the locations data
uniqueId Company ID -OR- DUNS Number See note above
\optionalResponseFields\includeTopExecutives Flag that determines whether to include the top executives data
\optionalResponseFields\includeStocks Flag that determines whether to include the stock data

Output Parameters

Field Name Value Notes
\return\top-executives\official\latest-salary\year Latest salary year
\return\top-executives\official\latest-salary\total-salary Total compensation for the year, including any bonus or other compensation in USD
\return\socialMedia\youTube\youTubeSubscribers Number of YouTube subscribers
\return\marketingPreScreenScore The D&B Marketing Prescreen value for this company
\return\top-executives Top 3 Company Executives
\return\keyFinancials\incomeAssets\salesGrowthPercent Sales growth in percent for this company
\return\top-executives\official\person\full-name Person Full Name
\return\industries\allUSSIC Collection of all US SIC Codes
\return\keyFinancials\marketValueInfo Contains market value information
\return\historicalIndicator Flag to indicate if this is a Boneyard (historical) Company
\return\socialMedia\wikipedia Wikipedia page information
\return\spaceAtAddressAccuracy Accuracy of spaceAtAddress field
\return\top-executives\official\connectMail\connectMailEmailSource Indicates if official's email is a ConnectMail contact
\return\keyNumbersHistory\[annualKeyNumbersHistory OR quarterlyKeyNumbersHistory]\keyNumbers\researchAndDevelopment R&D Expenses for the Year This value is in US dollars.
\return\womenOwned Indicates if the company is owned by women
\return\keyFinancials\incomeAssets\assets Total assets (in millions of USD) of this company
\return\keyNumbersHistory\[annualKeyNumbersHistory OR quarterlyKeyNumbersHistory]\keyNumbers\employeesTotal Total Employees
\return\ultimateParentName The Ultimate Parent name corresponding to the ultimate parent DUNS number
\return\ukSpecs UK-specific information
\return\legalStatus Legal Status description for the company
\return\keyNumbersHistory\[annualKeyNumbersHistory OR quarterlyKeyNumbersHistory]\keyNumbers\totalEmployeeGrowthPercent Total Employee Growth % for the Year
\return\industries\primaryUSSIC US SIC Code
\return\top-executives\official\latest-position\end-year Latest position end year
\return\name Company Name
\return\socialMedia\youTube\youTubeChannel YouTube channel
\return\top-executives\official\person\prefix Person Prefix
\return\locations\stateOfIncorporation Company State of Incorporation
\return\synopsis Company Description
\return\rankings\rank\definition The name of the ranking list, such as 'Fortune 500'
\return\keyFinancials\incomeAssets Contains income asset information
\return\socialMedia\facebook Facebook account information
\return\stocks\tickerUS Ticker Symbol used for this company.
\return\parentDuns ID of the company's immediate parent
\return\yearFounded Year the company was founded
\return\industries\allUKSIC\item\code UK SIC Code
\return\locations\countryId Company Country ID
\return\industries\allUSSIC\item\ussic US SIC Code
\return\phone Company Phone Numbers
\return\keyNumbersHistory\[annualKeyNumbersHistory OR quarterlyKeyNumbersHistory]\keyNumbers Financial Figures Previous version of API did not specify maxOccurs=unbounded, so generated client code was only able to get a single element. The API has changed to return an array or other collection.
\return\industries\primaryDnBIC DNBIC Code Replaces dnbicName (DNBIC Name)
\return\spaceAtAddressUnitOfMeasurement Unit of measurement for spaceAtAddress
\return\locationType Company Location Type such as Head Quarters, Single Location, etc
\return\top-executives\official\latest-position\start-year Latest position start year
\return\socialMedia Contains social media information for the company
\return\top-executives\official\latest-salary\salary Salary for the year, excluding bonus in USD
\return\locations\state Company State
\return\top-executives\official\connectMail\connectMailPhoneSource Indicates if official's phone number is a ConnectMail contact
\return\industries\allNAICS\item\naics NAICS code
\return\numberOfPCs Number of PCs at the company
\return\top-executives\official\person\last-name Person Last Name
\return\ukSpecs\numberOfSubsidiaries Number of subsidiaries
\return\socialMedia\twitter\twitterFollowers Number of Twitter followers
\return\industries\allNAICS Collection NAICS codes for the company
\return\top-executives\official Company Executive
\return\nonMarketableCompany NonMarketable Company reason e.g. Out of business
\return\primaryURLs Company Primary URLs in sorted in ascending order
\return\keyFinancials Contains market value and income asset information
\return\stocks\exchangeInfoList\exchangeInfo\exchangeName Exchange name where this company is traded.
\return\dbaNames Contains all Doing Business As names
\return\industries\allDnBIC Collection of all Industry Codes
\return\primaryURLs\primaryURL\url A primary url for a company
\return\locations\addressType Address Type such as Primary, Headquarters, Mailing etc.
\return\rankings A list of rankings that the company appears in, such as Fortune 500
\return\companyType Company Type such as Public, Private, etc
\return\keyFinancials\incomeAssets\netIncome Net income (in millions of USD) of this company
\return\locations Company Addresses Previous version of API did not specify maxOccurs=unbounded, so generated client code was only able to get a single element. The API has changed to return an array or other collection.
\return\manufacturingIndicator Indicates if the company is a manufacturer
\return\top-executives\official\person\suffix Person Suffix
\return\historicalText Brief description of why the company is defunct/td]
\return\locations\country Company Country Name Previous version of the API displayed Country Id in this element. API is changed to display CountryName.
\return\industries\allUSSIC\item\description Description of the industry represented by the USSIC
\return\keyNumbersHistory\[annualKeyNumbersHistory OR quarterlyKeyNumbersHistory]\keyNumbers\periodEndMonth Period End Month
\return\socialMedia\wikipedia\wikipediaUrl URL of Wikipedia page
\return\duns DUNS number of this company.
\return\locations\zip4 Company Zip Plus 4
\return\socialMedia\twitter\twitterUsername Twitter account username
\return\phones\[phoneNumber | faxNumber]\areaCode Phone Number Area Code
\return\parentName Company name of this company's immediate parent.
\return\industries\allUKSIC\item\description Description of industry referred to
\return\industries\allNAICS\item\description Description of the industry represented by the NAICS
\return\companyId Company ID
\return\top-executives\official\person\middle-name Person Middle Name
\return\ukSpecs\numberOfSubsidiaries\domestic Number of subsidiaries in the UK
\return\spaceAtAddress Space in square feet at the location
\return\ownershipYear Ownership Year
\return\full-description Full Company Description
\return\keyNumbersHistory\[annualKeyNumbersHistory OR quarterlyKeyNumbersHistory]\keyNumbers\sales Annual Sales This value is in US dollars.
\return\subsidiaryStatus Subsidiary Status
\return\stocks\exchangeInfoList\exchangeInfo\country Country name where exchange is located.
\return\socialMedia\facebook\facebookUsername Facebook username
\return\ultimateParentDuns The Ultimate Parent DUNS number
\return\keyFinancials\marketValueInfo\marketValueDate Date of market valuation
\return\top-executives\official\latest-position\title Person Title
\return\bankName The bank name for this company
\return\locations\metroArea The metropolitan area for the location
\return\socialMedia\twitter\twitterDisplayName Twitter name
\return\industries\allDNBIC\item\description Description of the industry represented by the DNBIC
\return\minorityOwned Indicates if the company is owned by a minority
\return\stocks\exchangeInfoList\exchangeInfo\tickerSymbol Ticker Symbol used for this company in this exchange.
\return\stocks\exchangeInfoList Collection of exchange information.
\return\top-executives\official\latest-salary\bonus Bonus for the year, in USD
\return\locations\latLongAccuracy Accuracy of latitude and longitude
\return\keyNumbersHistory\[annualKeyNumbersHistory OR quarterlyKeyNumbersHistory]\keyNumbers\employeesAtThisLocation Employees at this Location
\return\top-executives\official\connectMail Wrapper element for ConnectMail indicators
\return\rankings\rank\rankNumber A company's rank on a ranking list, such as 100 on the Fortune 500
\return\keyNumbersHistory\[annualKeyNumbersHistory OR quarterlyKeyNumbersHistory]\keyNumbers\advertising Advertising Expenses for the Year This value is in US dollars.
\return\industries\allUKSIC Collection of all UK SIC Codes
\return\socialMedia\facebook\facebookFans Number of Facebook fans
\return\locations\address1 Company Address
\return\locations\address2 Company Address Line 2
\return\industries\primaryUKSIC Primary UK SIC Code
\return\phones\[phoneNumber | faxNumber]\doNotCallRegistry Indicates whether company is listed on a UK Do Not Call registry
\return\primaryURLs\primaryURL\sortOrder A number indicating the relative order of the accompanying url among all primary urls
\return\locations\county Company County
\return\locations\latitude Latitude
\return\ukSpecs\uKRegistration UK Registration Number e.g. 3443456
\return\phones\[phoneNumber | faxNumber]\phoneNumber Phone Number
\return\top-executives\official\person\age Person Age
\return\ukSpecs\uKVAT UK Vat Number e.g. 906565610
\return\locations\longitude Longitude
\return\dbaNames\dba Doing Business As
\return\keyNumbersHistory\annualKeyNumbersHistory Annual Financial Figures
\return\ownedOrLeased Indicates if the company's location is owned/leased
\return\top-executives\official\latest-position Most recent position information
\return\socialMedia\youTube YouTube account
\return\socialMedia\twitter Twitter account information
\return\ethnicity Ethnicity of business owner.
\return\phones\[phoneNumber | faxNumber]\countryCode Address Country ID
\return\industries\primaryNAICS NAICS Code
\return\top-executives\official\latest-salary Most recent salary information
\return\URLs Company URLS
\return\locations\zip Company Zip Code
\return\keyFinancials\incomeAssets\netIncomeGrowthPercent Net income growth in percent of this company
\return\keyFinancials\incomeAssets\period Fiscal Period reporting date
\return\accountingFirm The accounting firm/auditor for this company
\return\top-executives\official\coOfficialId Official ID
\return\top-executives\official\person\first-name Person First Name
\return\top-executives\official\jobFunction Job Function
\return\top-executives\official\connectMail\connectMailNameSource Indicates if official's name is a ConnectMail contact
\return\keyFinancials\marketValueInfo\marketValue Market value (in millions of USD) of this company
\return\locations\city Company City
\return\keyNumbersHistory\[annualKeyNumbersHistory OR quarterlyKeyNumbersHistory]\keyNumbers\record-type Sales Record Type Q = quarter, A = annual
\return\industries\allDNBIC\item\DnBIC Industry Code
\return\keyNumbersHistory\quarterlyKeyNumbersHistory Quarterly Financial Figures

Input XML

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sch="http://applications.dnb.com/webservice/schema/">
   <soapenv:Header>
      <sch:API-KEY>YOUR-API-KEY-HERE</sch:API-KEY>
   </soapenv:Header>
   <soapenv:Body>
      <sch:GetCompanyDetailOptionalDataRequest>
         <sch:uniqueId>10977000000000</sch:uniqueId>
         <sch:optionalResponseFields>
            <sch:includeIndustries>false</sch:includeIndustries>
            <sch:includeKeyNumbers>false</sch:includeKeyNumbers>
            <sch:includeLocations>false</sch:includeLocations>
            <sch:includePhones>false</sch:includePhones>
            <sch:includeRankings>false</sch:includeRankings>
            <sch:includeStocks>false</sch:includeStocks>
            <sch:includeTopExecutives>false</sch:includeTopExecutives>
            <sch:includeURLs>false</sch:includeURLs>
         </sch:optionalResponseFields>
      </sch:GetCompanyDetailOptionalDataRequest>
   </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:GetCompanyDetailOptionalDataResponse xmlns:sch="http://applications.dnb.com/webservice/schema/">
         <sch:return>
            <sch:companyId>10977000000000</sch:companyId>
            <sch:duns>177667227</sch:duns>
            <sch:companyType>PUBLIC</sch:companyType>
            <sch:locationType>HEADQUARTERS</sch:locationType>
            <sch:ultimateParentDuns>177667227</sch:ultimateParentDuns>
            <sch:ultimateParentName>McKesson Corporation</sch:ultimateParentName>
            <sch:parentDuns>177667227</sch:parentDuns>
            <sch:parentName>McKesson Corporation</sch:parentName>
            <sch:name>McKesson Corporation</sch:name>
            <sch:dbaNames/>
            <sch:subsidiaryStatus>false</sch:subsidiaryStatus>
            <sch:ownershipYear>1833</sch:ownershipYear>
            <sch:synopsis><p>McKesson moves medicine. The largest pharmaceuticals distributor in North America, McKesson delivers prescription and generic drugs, as well as health and beauty care products, to more than 40,000 retail and institutional pharmacies throughout the US and Canada. The company is also a major medical supplies wholesaler, providing medical and surgical equipment to alternate health care sites, such as doctors' offices, surgery centers, and long-term care facilities. In addition to distribution services, McKesson offers software and technical services that help pharmacies, health care providers, and insurers manage supply chain, clinical, administrative, and financial operations.</p></sch:synopsis>
            <sch:full-description><p>McKesson moves medicine. The largest pharmaceuticals distributor in North America, McKesson delivers prescription and generic drugs, as well as health and beauty care products, to more than 40,000 retail and institutional pharmacies throughout the US and Canada. The company is also a major medical supplies wholesaler, providing medical and surgical equipment to alternate health care sites, such as doctors' offices, surgery centers, and long-term care facilities. In addition to distribution services, McKesson offers software and technical services that help pharmacies, health care providers, and insurers manage supply chain, clinical, administrative, and financial operations.</p>
  <p>McKesson's distribution operations bring in most of the company's money. The McKesson Distribution Solutions division primarily provides prescription and over-the-counter pharmaceuticals and other health care items to retailers and health care institutions in the US; it also is a wholesaler of drugs in Canada and owns about half of Nadro, a Mexican pharma distributor. The distribution division also supplies medical equipment and beauty care items, and it provides consulting and inventory management services. Major US pharmacy operators <Company ID="10984">CVS Caremark</Company> and <Company ID="11278">Rite Aid</Company> are among the company's key clients, each accounting for more than 10% of sales.</p>

<p>Outside its traditional retail and institutional distribution operations, McKesson provides disease management programs that serve health providers, drug manufacturers, insurers, and employers. Its specialty pharmacy solutions unit coordinates the delivery of complex medicines directly to physicians. Additionally, the company supplies automated pharmacy dispensing systems through its minority stake in North Carolina-based Parata Systems, and it provides first aid kits and workplace safety training through subsidiary <Company ID="111978">ZEE Medical</Company>. McKesson launched a new Plasma and BioLogics division in 2008; the unit delivers plasma and plasma-related products to hospital pharmacies.</p>

<p>Strategic acquisitions have been important to the growth of the company, both in its core distribution operations and its smaller but growing Technology Solutions (software and data management) division. The company regularly purchases small to midsized regional distributors and distribution support companies, including the 2008 purchase of Midwest pharmacy distributor <Company ID="110974">McQueary Brothers</Company> for $190 million. McKesson also widens its product offerings by forming new partnerships with its suppliers.</p>

<p>With an eye on eventual health reform, in 2011 the company acquired Portico Systems, a company that manages information technology for health plans. McKesson paid about $90 million for Portico Systems, whose information management tools are used by some 40 payer and provider networks.</p>

<p>To expand its offering of cancer treatment drugs and oncology practice support services, in late 2010 McKesson acquired <Company ID="43674">US Oncology</Company> for a total of $2.16 billion in a combination of cash and assumed debt. It then combined US Oncology with its existing Specialty Care Solutions business and moved the operations into US Oncology's facilities in Texas.</p>

<p>While McKesson seeks to grow its operations to provide a complementary array of solutions and maintain its leading edge, the company has also trimmed some operations to focus on core drug distribution and technology initiatives. It sold specialty pharmacy unit <Company ID="104923">ivpcare</Company> to <Company ID="11601">Walgreen</Company> in 2008.</p></sch:full-description>
            <sch:historicalIndicator>false</sch:historicalIndicator>
            <sch:historicalText/>
            <sch:accountingFirm>Deloitte & Touche LLP San Fra</sch:accountingFirm>
            <sch:bankName/>
            <sch:marketingPreScreenScore>L</sch:marketingPreScreenScore>
            <sch:keyFinancials>
               <sch:marketValueInfo>
                  <sch:marketValue>17334.8755</sch:marketValue>
                  <sch:marketValueDate>2011-10-07</sch:marketValueDate>
               </sch:marketValueInfo>
               <sch:incomeAssets/>
            </sch:keyFinancials>
            <sch:ukSpecs/>
            <sch:numberOfPCs>140</sch:numberOfPCs>
            <sch:spaceAtAddress>215000</sch:spaceAtAddress>
            <sch:spaceAtAddressUnitOfMeasurement>sq ft</sch:spaceAtAddressUnitOfMeasurement>
            <sch:spaceAtAddressAccuracy>0</sch:spaceAtAddressAccuracy>
            <sch:ownedOrLeased>Location Is Rented By This Company</sch:ownedOrLeased>
            <sch:manufacturingIndicator/>
            <sch:minorityOwned>false</sch:minorityOwned>
            <sch:ethnicity>Unknown</sch:ethnicity>
            <sch:franchiseOperationType>Owned by Franchisee</sch:franchiseOperationType>
            <sch:womenOwned>false</sch:womenOwned>
            <sch:yearFounded>1833</sch:yearFounded>
            <sch:legalStatus>Corporation</sch:legalStatus>
         </sch:return>
      </sch:GetCompanyDetailOptionalDataResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

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>

Get Family Tree

Overview

Returns ultimate parent of the given DUNS or Company ID and all of the children/descendants of that ultimate parent. Access to the GetFamilyTree service operation has been restricted. Please contact your sales representative for access.

Input Parameters

Field Name Value Notes
uniqueId Company ID -OR- DUNS Number
filters/includeIncompleteData If true, will return all the unmarketable company records, which have incomplete data.
filters/locationType Location Type Use multiple elements for multiple location type values.
filters/includeOutOfBusiness If true, will return all the unmarketable company records, which are out of business.
filters/includeUndeliverableAddress If true, will return all the unmarketable company records, which have undeliverable address.
filters/includeDoNotMarketTo If true, will return all the unmarketable company records, which have undeliverable address.
filters Optional element used to filter the family tree results.
filters/depthLimit The number of layers or levels of the family tree structure to return. An error will be returned if the value is less than 1.
filters/country Country Use multiple elements for multiple country values.
filters/state State Use multiple elements for multiple state values.
filters/city City Use multiple elements for multiple city values.

Output Parameters

Field Name Value Notes
\return\children\child\revenue Child Revenue in millions of USD
\return\parentDuns Parent Company DUNS Number
\return\city Company City
\return\duns DUNS Number
\return\revenue Revenue in millions
\return\children\child\number Hit Number of the specific child
\return\children\child\parentDuns Child Parent Company DUNS Number
\return\additionalData\doNotMarketTo Indicates true if the company is listed as do not market to.
\return\children\child\additionalData\incompleteData Indicates true, If the company has incomplete data
\return\companyId Company ID
\return\children\child\locationType Child Location Type Headquarters, Branch, etc.
\return\children\child\name Child Company Name
\return\additionalData\undeliverableAddress Indicates true if the company has an undeliverable address
\return\children\child\country Child Company Country
\return\children\child\additionalData\undeliverableAddress Indicates true, If the company has undeliverable address
\return\children\child\companyId Child Company ID
\return\children\child\duns Child DUNS Number
\return\children This company's children Previous version of API did not specify maxOccurs=unbounded, so generated client code was only able to get a single element. The API has changed to return an array or other collection.
\return\ultimateParentDuns Ultimate Parent Company DUNS Number
\return\children\child\additionalData\outOfBusiness Indicates true, If the company is out of business
\return\additionalData Additional data about the company
\return\locationType Location Type Headquarters, Branch, etc.
\return\additionalData\outOfBusiness Indicates true if the company is out of business
\return\additionalData\incompleteData Indicates true if the company has incomplete data
\return\children\child\additionalData AdditionalData about the company
\return\children\child\city Child Company City
\return\children\child\ultimateParentDuns Child Ultimate Parent Company DUNS Number
\return\currencyType CurrencyType of Revenue
\return\children\child\children This company's children Previous version of API did not specify maxOccurs=unbounded, so generated client code was only able to get a single element. The API has changed to return an array or other collection.
\return\children\child\additionalData\doNotMarketTo Indicates true, If the company is delisted as do not market to.
\return\country Country
\return\totalChildren Aggregate Total Number of Children for this unique ID
\return\name Company Name
\return\state Company State
\return\children\child\currencyType Currency type of Revenue
\return\children\child\state Child Company State

Input XML

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sch="http://applications.dnb.com/webservice/schema/">
   <soapenv:Header>
      <sch:API-KEY>YOUR-API-KEY-HERE</sch:API-KEY>
   </soapenv:Header>
   <soapenv:Body>
      <sch:GetFamilyTreeRequest>
         <sch:uniqueId>15751000000000</sch:uniqueId>
         <sch:filters>           
            <sch:includeUndeliverableAddress>false</sch:includeUndeliverableAddress>
            <sch:includeOutOfBusiness>false</sch:includeOutOfBusiness>
            <sch:includeIncompleteData>false</sch:includeIncompleteData>
            <sch:includeDoNotMarketTo>false</sch:includeDoNotMarketTo>
         </sch:filters>
      </sch:GetFamilyTreeRequest>
   </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:GetFamilyTreeResponse xmlns:sch="http://applications.dnb.com/webservice/schema/">
         <sch:return>
            <sch:name>Craftmade International, Inc.</sch:name>
            <sch:companyId>15751000000000</sch:companyId>
            <sch:duns>007918592</sch:duns>
            <sch:parentDuns>007918592</sch:parentDuns>
            <sch:ultimateParentDuns>007918592</sch:ultimateParentDuns>
            <sch:revenue>153.92</sch:revenue>
            <sch:currencyType>USD</sch:currencyType>
            <sch:locationType>HEADQUARTERS</sch:locationType>
            <sch:city>Coppell</sch:city>
            <sch:state>TX</sch:state>
            <sch:country>United States</sch:country>
            <sch:additionalData>
               <sch:undeliverableAddress>false</sch:undeliverableAddress>
               <sch:outOfBusiness>false</sch:outOfBusiness>
               <sch:incompleteData>false</sch:incompleteData>
               <sch:doNotMarketTo>false</sch:doNotMarketTo>
            </sch:additionalData>
            <sch:totalChildren>7</sch:totalChildren>
            <sch:children>
               <sch:child>
                  <sch:number>1</sch:number>
                  <sch:name>Woodard, LLC</sch:name>
                  <sch:companyId>1955020</sch:companyId>
                  <sch:duns>001955020</sch:duns>
                  <sch:parentDuns>007918592</sch:parentDuns>
                  <sch:ultimateParentDuns>007918592</sch:ultimateParentDuns>
                  <sch:revenue xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                  <sch:currencyType xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                  <sch:locationType>HEADQUARTERS</sch:locationType>
                  <sch:city>Coppell</sch:city>
                  <sch:state>TX</sch:state>
                  <sch:country>United States</sch:country>
                  <sch:additionalData>
                     <sch:undeliverableAddress>false</sch:undeliverableAddress>
                     <sch:outOfBusiness>false</sch:outOfBusiness>
                     <sch:incompleteData>false</sch:incompleteData>
                     <sch:doNotMarketTo>false</sch:doNotMarketTo>
                  </sch:additionalData>
                  <sch:children>
                     <sch:child>
                        <sch:number>2</sch:number>
                        <sch:name>Woodard--Cm, LLC</sch:name>
                        <sch:companyId>5801631</sch:companyId>
                        <sch:duns>005801631</sch:duns>
                        <sch:parentDuns>001955020</sch:parentDuns>
                        <sch:ultimateParentDuns>007918592</sch:ultimateParentDuns>
                        <sch:revenue xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                        <sch:currencyType xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                        <sch:locationType>BRANCH</sch:locationType>
                        <sch:city>Owosso</sch:city>
                        <sch:state>MI</sch:state>
                        <sch:country>United States</sch:country>
                        <sch:additionalData>
                           <sch:undeliverableAddress>false</sch:undeliverableAddress>
                           <sch:outOfBusiness>false</sch:outOfBusiness>
                           <sch:incompleteData>false</sch:incompleteData>
                           <sch:doNotMarketTo>false</sch:doNotMarketTo>
                        </sch:additionalData>
                     </sch:child>
                  </sch:children>
               </sch:child>
               <sch:child>
                  <sch:number>3</sch:number>
                  <sch:name>Durocraft International, Inc.</sch:name>
                  <sch:companyId>787443753</sch:companyId>
                  <sch:duns>787443753</sch:duns>
                  <sch:parentDuns>007918592</sch:parentDuns>
                  <sch:ultimateParentDuns>007918592</sch:ultimateParentDuns>
                  <sch:revenue xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                  <sch:currencyType xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                  <sch:locationType>SINGLE_LOCATION</sch:locationType>
                  <sch:city>Coppell</sch:city>
                  <sch:state>TX</sch:state>
                  <sch:country>United States</sch:country>
                  <sch:additionalData>
                     <sch:undeliverableAddress>false</sch:undeliverableAddress>
                     <sch:outOfBusiness>false</sch:outOfBusiness>
                     <sch:incompleteData>false</sch:incompleteData>
                     <sch:doNotMarketTo>false</sch:doNotMarketTo>
                  </sch:additionalData>
               </sch:child>
               <sch:child>
                  <sch:number>4</sch:number>
                  <sch:name>Trade Source International, Inc</sch:name>
                  <sch:companyId>119083640</sch:companyId>
                  <sch:duns>119083640</sch:duns>
                  <sch:parentDuns>007918592</sch:parentDuns>
                  <sch:ultimateParentDuns>007918592</sch:ultimateParentDuns>
                  <sch:revenue>13.60</sch:revenue>
                  <sch:currencyType>USD</sch:currencyType>
                  <sch:locationType>HEADQUARTERS</sch:locationType>
                  <sch:city>Coppell</sch:city>
                  <sch:state>TX</sch:state>
                  <sch:country>United States</sch:country>
                  <sch:additionalData>
                     <sch:undeliverableAddress>false</sch:undeliverableAddress>
                     <sch:outOfBusiness>false</sch:outOfBusiness>
                     <sch:incompleteData>false</sch:incompleteData>
                     <sch:doNotMarketTo>false</sch:doNotMarketTo>
                  </sch:additionalData>
                  <sch:children>
                     <sch:child>
                        <sch:number>5</sch:number>
                        <sch:name>Prime Home Impressions LLC</sch:name>
                        <sch:companyId>119719842</sch:companyId>
                        <sch:duns>119719842</sch:duns>
                        <sch:parentDuns>119083640</sch:parentDuns>
                        <sch:ultimateParentDuns>007918592</sch:ultimateParentDuns>
                        <sch:revenue xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                        <sch:currencyType xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                        <sch:locationType>SINGLE_LOCATION</sch:locationType>
                        <sch:city>Coppell</sch:city>
                        <sch:state>TX</sch:state>
                        <sch:country>United States</sch:country>
                        <sch:additionalData>
                           <sch:undeliverableAddress>false</sch:undeliverableAddress>
                           <sch:outOfBusiness>false</sch:outOfBusiness>
                           <sch:incompleteData>false</sch:incompleteData>
                           <sch:doNotMarketTo>false</sch:doNotMarketTo>
                        </sch:additionalData>
                     </sch:child>
                     <sch:child>
                        <sch:number>6</sch:number>
                        <sch:name>TRADE SOURCE INTERNATIONAL, INC</sch:name>
                        <sch:companyId>609366109</sch:companyId>
                        <sch:duns>609366109</sch:duns>
                        <sch:parentDuns>119083640</sch:parentDuns>
                        <sch:ultimateParentDuns>007918592</sch:ultimateParentDuns>
                        <sch:revenue xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                        <sch:currencyType xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                        <sch:locationType>BRANCH</sch:locationType>
                        <sch:city>Dedham</sch:city>
                        <sch:state>MA</sch:state>
                        <sch:country>United States</sch:country>
                        <sch:additionalData>
                           <sch:undeliverableAddress>false</sch:undeliverableAddress>
                           <sch:outOfBusiness>false</sch:outOfBusiness>
                           <sch:incompleteData>false</sch:incompleteData>
                           <sch:doNotMarketTo>false</sch:doNotMarketTo>
                        </sch:additionalData>
                     </sch:child>
                     <sch:child>
                        <sch:number>7</sch:number>
                        <sch:name>Trade Source International, Inc</sch:name>
                        <sch:companyId>175929822</sch:companyId>
                        <sch:duns>175929822</sch:duns>
                        <sch:parentDuns>119083640</sch:parentDuns>
                        <sch:ultimateParentDuns>007918592</sch:ultimateParentDuns>
                        <sch:revenue xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                        <sch:currencyType xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                        <sch:locationType>BRANCH</sch:locationType>
                        <sch:city>Prairie Grove</sch:city>
                        <sch:state>AR</sch:state>
                        <sch:country>United States</sch:country>
                        <sch:additionalData>
                           <sch:undeliverableAddress>false</sch:undeliverableAddress>
                           <sch:outOfBusiness>false</sch:outOfBusiness>
                           <sch:incompleteData>false</sch:incompleteData>
                           <sch:doNotMarketTo>false</sch:doNotMarketTo>
                        </sch:additionalData>
                     </sch:child>
                  </sch:children>
               </sch:child>
            </sch:children>
         </sch:return>
      </sch:GetFamilyTreeResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Advanced Person Search

Overview

Returns search result of people based on various different criteria. Please note that, the maximum number of records that can be pulled is 200 per call with a total maximum of 10,000.

Input Parameters

Field Name Value Notes
\bal\maxrecords Max Records Between 1-200. Default = 20
\bal\hitOffset Greater than or equal to 0 but less than or equal to 10,000. Default = 0 Paging support, the firstHit returned will be hitOffset + 1. hitOffset is now zero-based.
\bal\sortdirection Sort Direction Values defined in WSDL: SortDirectionTypes - ascending or descending
\bal\location\county\countyId County ID ID Value from GetAdvancedSearchLookups
\bal\location\zipAreaSearch\zipCode Zipcode to search within (78745 in the example) e.g. Find results within 50 miles of 78745 (up to a maximum radius of 100 miles or 160 km). Use only one 5-digit ZIP code. Requires zipareawithin and zipareazipcode.
\bal\specialtyCriteria\ownedOrRented Company resides in Owned or Rented Space
\bal\financialdata\tradingDateTo Trading Date Upper Bound MM/DD/YYYY
\bal\industry\uKSICRange\[from|to] UKSIC Code Ranges Enter one or more range elements. Each range element must contain 'from' and a 'to' element.
\bal\industry\nAICSRange\[from|to] NAICS Code Ranges Enter one or more range elements. Each range element must contain 'from' and a 'to' element.
\bal\companySize\employeesThisLocationTo Employees at this Location Upper Bound
\bal\companySize\employeesFrom Total Employees Lower Bound
\bal\specialtyCriteria\companyKeyword Company Keyword e.g. laptops or China or acquired, merged, takeover
\bal\companyType\location Location Type ID Value from GetAdvancedSearchLookups
\bal\companySize\marketCapFrom Market Cap ($ mil) Lower Bound
\bal\people\bonusTo Person Bonus ($) Upper Bound
\bal\specialtyCriteria\yearFoundingFrom Year of Founding or Change in Control Lower Bound YYYY
\bal\specialtyCriteria\squareFootRangeTo Company square foot range to
\bal\location\city City e.g. Madrid or New York (single city only)
\bal\location\zipAreaSearch\scale Units to search in: miles or kilometers e.g. Find results within 50 miles of 78745 (up to a maximum radius of 100 miles or 160 km). Use only one 5-digit ZIP code. Requires zipareawithin and zipareazipcode.
\bal\specialtyCriteria\duns DUNS Number
\bal\specialtyCriteria\ethnicity Ethnicity of the company owner Values defined in WSDL - Ethnicity enumeration
\bal\usZipCodeRange\from US ZIP Code Lower Bound
\bal\companyType\subsidiaryStatus Subsidiary Status Subsidiary or Not a Subsidiary
\bal\financialdata\incomeGrowthTo Net Income Growth (%) Upper Bound
\bal\companySize\employeesThisLocationFrom Employees at this Location Lower Bound
\bal\companyType\ownershipType Values are 1 (Public), 21 (Owned by a Public Company) or 0 (Non-Public).
\bal\financialdata\researchExpenseTo R&D Expense ($ mil) Upper Bound
\bal\people\jobFunctionId Person Job Function ID ID Value from GetAdvancedSearchLookups.
\bal\location\streetAddress Street Address e.g. 1700 Pennsylvania Ave.
\bal\people\lastName Person Last Name
\bal\people\firstName Person First Name
\bal\location\county Wrapper for county type Searching by multiple counties is allowed, send in multiple county wrapper elements
\bal\specialtyCriteria\rankingId Rankings/Indices ID Value from GetAdvancedSearchLookups
\bal\financialdata\incomeGrowthFrom Net Income Growth (%) Lower Bound
\bal\specialtyCriteria\companyName Company Name
\bal\people\ageFrom Person Age Lower Bound
\bal\industry\uKSIC UK SIC Code Enter only one code per element. Use multiple elements for multiple codes. Enter at least two digits per code. No CSV or Ranges can be specified
\bal\financialdata\offerFrom US IPO Data - Offer Amount ($ mil.) Lower Bound
\bal\location\regionId World Region ID Value from GetAdvancedSearchLookups
\bal\industry\nAICS NAICS Code Enter only one code per element. Use multiple elements for multiple codes. Enter at least two digits per code. No CSV or Ranges can be specified
\bal\financialdata\advertisingExpenseFrom Ad Expense ($ mil) Lower Bound
\bal\specialtyCriteria\auditorId Auditors ID Value from GetAdvancedSearchLookups
\bal\orderby Order By Values defined in WSDL: BaseOrderByTypes
\bal\financialdata\assetsFrom Assets ($ mil) Lower Bound
\bal\specialtyCriteria\legalStatus Legal Status of the company Values defined in WSDL - Legal Status enumeration
\bal\financialdata\filingDateFrom Filing Date Lower Bound YYYY-MM-DD
\bal\financialdata\incomeTo Net Income ($ mil) Upper Bound
\bal\location\postalCode Postal Code e.g. 78701 or "SW1P 1JA" or "SW1" or Separate multiple ZIP codes by commas.
\bal\location\latLongSearch\latitude latitude Requires scale, radius, and longitude.
\bal\companySize\employeesTo Total Employees Upper Bound
\bal\companySize\employeesGrowthTo Total Employees Growth Percentage Upper Bound
\bal\people\totalPayFrom Person Total Pay ($) Lower Bound
\bal\industry\primaryOnly Primary Industry Only Boolean
\bal\location\allAny All or Any Matches on Location Criteria Matching ALL means a company would have to match each type of criteria entered. Matching ANY means that a company could match any single type of criteria entered. Valid values All or Any
\bal\financialdata\underwriterId Underwriters ID Value from GetAdvancedSearchLookups It searches only the lead underwriter for the given underwriterId.
\bal\specialtyCriteria\primaryUrl Primary URL
\bal\financialdata\advertisingExpenseTo Ad Expense ($ mil) Upper Bound.
\bal\usZipCodeRange\to US ZIP Code Upper Bound
\bal\financialdata\incomeFrom Net Income ($ mil) Lower Bound
\bal\companySize\employeesGrowthFrom Total Employees Growth Percentage Lower Bound
\bal\financialdata\assetsTo Assets ($ mil) Upper Bound
\bal\people\totalPayTo Person Total Pay ($) Upper Bound
\bal\location\countryId Country ID Value from GetAdvancedSearchLookups
\bal\people\salaryFrom Person Salary ($) Lower Bound
\bal\financialdata\researchExpenseFrom R&D Expense ($ mil) Lower Bound
\bal\specialtyCriteria\squareFootageFrom Company square foot range from
\bal\location\latLongSearch\longitude longitude Requires scale, radius, and latitude.
\bal\people\keywordSelect Person Keyword e.g. marketing or Harvard or ad sales
\bal\location\metropolitanId US Metropolitan Area ID Value from GetAdvancedSearchLookups
\bal\financialdata\fiscalYearEnd Fiscal Year End Month
\bal\companySize\marketCapTo Market Cap ($ mil) Upper Bound
\bal\people\salaryTo Person Salary ($) Upper Bound
\bal\companySize\salesGrowthTo Annual Sales Growth (%) Upper Bound
\bal\specialtyCriteria\ukVat UK Vat Number e.g. 906565610 Use multiple elements for multiple UK VAT values
\bal\financialdata\filingDateTo Filing Date Upper Bound YYYY-MM-DD
\bal\companySize\salesTo Annual Sales ($ mil) Upper Bound
\bal\people\keywordsIn Keywords In Title or Bio
\bal\specialtyCriteria\ultimateParentDuns The ultimate parent DUNS number for a family of companies eg. 060902413 or 884364530
\bal\people\bonusFrom Person Bonus ($) Lower Bound
\bal\location\county\countryId Country ID ID Value from GetAdvancedSearchLookups
\bal\specialtyCriteria\ukRegistration UK Registration Number e.g. 3443456 Use multiple elements for multiple UK Registration values
\bal\people\ageTo Person Age Upper Bound
\bal\specialtyCriteria\yearFoundingTo Year of Founding or Change in Control (YYYY) Upper Bound YYYY
\bal\location\globalState Global State/Province e.g Queensland or NY (single province/state only)
\bal\companySize\salesGrowthFrom Annual Sales Growth (%) Lower Bound
\bal\location\county\state State ID Value from GetAdvancedSearchLookups
\bal\companySize\salesFrom Annual Sales ($ mil) Lower Bound
\bal\specialtyCriteria\womenOwned Women Owned Company Boolean
\bal\location\zipAreaSearch\radius # of miles or kilometers to search within. e.g. Find results within 50 miles of 78745 (up to a maximum radius of 100 miles or 160 km). Use only one 5-digit ZIP code. Requires zipareawithin and zipareazipcode.
\bal\location\areacode US/Canada Area Code e.g. 512 or 210, 512, 212
\bal\location\usStateCanadaProvince US State/Canada Province
\bal\specialtyCriteria\exchangeId Exchange ID Value from GetAdvancedSearchLookups
\bal\industry\uSSICRange\[from|to] SIC Code Ranges Enter one or more range elements. Each range element must contain 'from' and a 'to' element.
\bal\financialdata\priceRangeTo US IPO Data - Price Range ($) Upper Bound
\bal\financialdata\priceRangeFrom US IPO Data - Price Range ($) Lower Bound
\bal\location\latLongSearch\scale Units to search in: miles or kilometers Requires radius, latitude, and longitude.
\bal\location\ukCounty UK County A valid UK County name
\bal\industry\IndustryCode Industry Name ID Value from GetAdvancedSearchLookups
\bal\financialdata\tradingDateFrom Trading Date Lower Bound MM/DD/YYYY
\bal\specialtyCriteria\minorityOwned Minority Owned Company Boolean
\bal\financialdata\offerTo US IPO Data - Offer Amount ($ mil.) Upper Bound
\bal\location\latLongSearch\radius # of miles or kilometers to search within. Requires scale, latitude, and longitude
\bal\industry\uSSIC US SIC Code Enter only one code per element. Use multiple elements for multiple codes. Enter at least two digits per code. No CSV or Ranges can be specified

Output Parameters

Field Name Value Notes
\return\people\lastHit Last Hit
\return\people\hit\coOfficialResults\suffix Person Suffix
\return\resultSet\hit\coOfficialResults\connectMail\connectMailNameSource Indicates if official's name is a ConnectMail contact
\return\resultSet\hit\coOfficialResults\connectMail\connectMailSource Indicates ConnectMail source
\return\people\hits Total Number of Hits in this Response
\return\people\hit\coOfficialResults\duns DUNS
\return\people\hit\coOfficialResults\nonMarketableCompany NonMarketable Company Reason Ex. Bankrupt, Out of Business
\return\resultSet\hit\coOfficialResults\connectMail\connectMailPhoneSource Indicates if official's phone number is a ConnectMail contact
\return\people\totalHits Aggregate Total Number of Hits This is the total number of results the search returned
\return\people\hit\hitNumber Hit Number
\return\resultSet\hit\coOfficialResults\connectMail Wrapper element for ConnectMail indicators
\return\people\hit\coOfficialResults\middleName Person Middle Name
\return\people\hit\coOfficialResults\fullName Person Full Name
\return\people\hit\coOfficialResults\title Person Title
\return\people\hit\coOfficialResults\companyName Company Name
\return\people\hit\coOfficialResults\coOfficialId Official ID
\return\people\hit\coOfficialResults\companyId Company ID
\return\people\firstHit First Hit
\return\people\hit\coOfficialResults\firstName Person First Name
\return\resultSet\hit\coOfficialResults\connectMail\connectMailEmailSource Indicates if official's email is a ConnectMail contact
\return\people\hit\coOfficialResults\lastName Person Last Name

Input XML

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sch="http://applications.dnb.com/webservice/schema/">
   <soapenv:Header>
      <sch:API-KEY>YOUR-API-KEY-HERE</sch:API-KEY>
   </soapenv:Header>
   <soapenv:Body>
      <sch:AdvancedPersonSearchRequest>
         <sch:bal>
            <sch:maxRecords>3</sch:maxRecords>
            <sch:hitOffset>0</sch:hitOffset>
            <sch:sortDirection>Ascending</sch:sortDirection>
            <sch:location>              
               <sch:usZipCodeRange>
                  <sch:from>78705</sch:from>
                  <sch:to>98547</sch:to>
               </sch:usZipCodeRange>  
	   </sch:location>
         </sch:bal>
      </sch:AdvancedPersonSearchRequest>
   </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:AdvancedPersonSearchResponse xmlns:sch="http://applications.dnb.com/webservice/schema/">
         <sch:return>
            <sch:people>
               <sch:firstHit>1</sch:firstHit>
               <sch:hits>3</sch:hits>
               <sch:lastHit>3</sch:lastHit>
               <sch:totalHits>9034980</sch:totalHits>
               <sch:hit>
                  <sch:hitNumber>1</sch:hitNumber>
                  <sch:coOfficialResults>
                     <sch:companyId>10059000000000</sch:companyId>
                     <sch:duns>144796497</sch:duns>
                     <sch:companyName>Allergan, Inc.</sch:companyName>
                     <sch:coOfficialId>5404219</sch:coOfficialId>
                     <sch:fullName>Thomas Chapman</sch:fullName>
                     <sch:firstName>Thomas</sch:firstName>
                     <sch:lastName>Chapman</sch:lastName>
                     <sch:middleName/>
                     <sch:suffix/>
                     <sch:title>Manager Pharmaceutical Analysis And Microbiology</sch:title>
                     <sch:connectMail>
                        <sch:connectMailNameSource>true</sch:connectMailNameSource>
                        <sch:connectMailEmailSource>true</sch:connectMailEmailSource>
                        <sch:connectMailPhoneSource>false</sch:connectMailPhoneSource>
                        <sch:connectMailSource>Jigsaw</sch:connectMailSource>
                     </sch:connectMail>
                  </sch:coOfficialResults>
               </sch:hit>
               <sch:hit>
                  <sch:hitNumber>2</sch:hitNumber>
                  <sch:coOfficialResults>
                     <sch:companyId>10059000000000</sch:companyId>
                     <sch:duns>144796497</sch:duns>
                     <sch:companyName>Allergan, Inc.</sch:companyName>
                     <sch:coOfficialId>20864890</sch:coOfficialId>
                     <sch:fullName>Joseph Harrigan</sch:fullName>
                     <sch:firstName>Joseph</sch:firstName>
                     <sch:lastName>Harrigan</sch:lastName>
                     <sch:middleName/>
                     <sch:suffix/>
                     <sch:title>Regional Accounts Manager</sch:title>
                     <sch:connectMail>
                        <sch:connectMailNameSource>true</sch:connectMailNameSource>
                        <sch:connectMailEmailSource>true</sch:connectMailEmailSource>
                        <sch:connectMailPhoneSource>true</sch:connectMailPhoneSource>
                        <sch:connectMailSource>Jigsaw</sch:connectMailSource>
                     </sch:connectMail>
                  </sch:coOfficialResults>
               </sch:hit>
               <sch:hit>
                  <sch:hitNumber>3</sch:hitNumber>
                  <sch:coOfficialResults>
                     <sch:companyId>10059000000000</sch:companyId>
                     <sch:duns>144796497</sch:duns>
                     <sch:companyName>Allergan, Inc.</sch:companyName>
                     <sch:coOfficialId>35600941</sch:coOfficialId>
                     <sch:fullName>Kulwinder Pannu</sch:fullName>
                     <sch:firstName>Kulwinder</sch:firstName>
                     <sch:lastName>Pannu</sch:lastName>
                     <sch:middleName/>
                     <sch:suffix/>
                     <sch:title>Manager Quality Control Microbiology</sch:title>
                     <sch:connectMail>
                        <sch:connectMailNameSource>true</sch:connectMailNameSource>
                        <sch:connectMailEmailSource>true</sch:connectMailEmailSource>
                        <sch:connectMailPhoneSource>false</sch:connectMailPhoneSource>
                        <sch:connectMailSource>Hoovers</sch:connectMailSource>
                     </sch:connectMail>
                  </sch:coOfficialResults>
               </sch:hit>
            </sch:people>
         </sch:return>
      </sch:AdvancedPersonSearchResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Get Person Detail

Overview

Returns search result of detailed person information based on criteria of a Official ID and Company ID. When calling this service, ensure the Official ID you send is a recent value from the Find Person by Keyword Search. These IDs are not constant and therefore sending an "old" Official ID will cause either invalid or no results.

Input Parameters

Field Name Value Notes
uniqueCompanyId Company ID or DUNS
coOfficialId Official ID
connectMail True or False; defaults to False Optional flag set to true when requesting ConnectMail data.
convertCurrencyTo Accepted Values are : USD, CAD, GBP, JPY, EUR, SEK only Specify the currency type in which the results should be in.Defaults to USD

Output Parameters

Field Name Value Notes
\return\official\coOfficialId Official ID
\return\official\currencyConvertedTo Currency in which the latest salary is returned Can be specified in the request using convertCurrencyTo element
\return\official\latestSalary Most recent salary information
\return\official\latestSalary\salary Salary for the year, excluding bonus
\return\official\latestSalary\totalSalary Total compensation for the year, including any bonus or other compensation
\return\official\latestSalary\bonus Bonus for the year
\return\official\latestSalary\year Latest salary year
\return\official\person\age Person Age
\return\official\person\fullName Person Full Name
\return\official\person\firstName Person First Name
\return\official\person\lastName Person Last Name
\return\official\person\middleName Person Middle Name
\return\official\person\prefix Person Prefix
\return\official\person\suffix Person Suffix
\return\official\contact Official Contact Information Wrapper
\return\official\contact\phoneNumber Contact phone number from ConnectMail
\return\official\contact\emailAddress Contact email address from ConnectMail
\return\official\connectMail Wrapper element for ConnectMail indicators
\return\official\connectMail\connectMailNameSource Indicates if official's name is a ConnectMail contact
\return\official\connectMail\connectMailEmailSource Indicates if official's email is a ConnectMail contact
\return\official\connectMail\connectMailPhoneSource Indicates if official's phone number is a ConnectMail contact
\return\resultSet\hit\coOfficialResults\connectMail\connectMailSource Indicates ConnectMail source
\return\official\latestPosition Most recent position information
\return\official\latestPosition\title Person Title
\return\official\latestPosition\jobFunction\jobFunctionId Job function ID
\return\official\latestPosition\startYear Latest position start year
\return\official\latestPosition\endYear Latest position end year
\return\official\latestPosition\titleText Latest position title text
\return\official\companyId Company ID
\return\official\duns DUNS number
\return\official\primaryCompanyPhone Primary phone number for the company
\return\official\nonMarketableCompany NonMarketable Company Reason e.g. Out of business
\return\official\biography Biographic Information
\return\official\biographySource Biography Source Name
\return\official\positionHistory Collection on position elements (position history for the official)
\return\official\positionHistory\position\title Person Title
\return\official\positionHistory\position\jobFunction Person Job Function
\return\official\positionHistory\position\startYear Position start year
\return\official\positionHistory\position\endYear Position end year
\return\official\positionHistory\position\titleText Latest position title text
\return\official\salaryHistory Collection of salary elements (salary history for the official)
\return\official\salaryHistory\salary\salary Salary for the year excluding bonus
\return\official\salaryHistory\salary\totalSalary Total compensation including bonus
\return\official\salaryHistory\salary\bonus Bonus for the year
\return\official\salaryHistory\salary\year Salary Year
\return\official\socialMediaData\linkedInAccountId LinkedIn Account ID

Input XML

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sch="http://applications.dnb.com/webservice/schema/">
   <soapenv:Header>
      <sch:API-KEY>YOUR-API-KEY-HERE</sch:API-KEY>
   </soapenv:Header>
   <soapenv:Body>
      <sch:GetPersonDetailRequest>
         <sch:uniqueCompanyId>52477000000000</sch:uniqueCompanyId>
         <sch:coOfficialId>2194866000000000</sch:coOfficialId>
         <sch:connectMail>false</sch:connectMail>
         <sch:convertCurrencyTo>USD</sch:convertCurrencyTo>
      </sch:GetPersonDetailRequest>
   </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:GetPersonDetailResponse xmlns:sch="http://applications.dnb.com/webservice/schema/">
         <sch:return>
            <sch:official>
               <sch:coOfficialId>2194866000000000</sch:coOfficialId>
               <sch:currencyConvertedTo>USD</sch:currencyConvertedTo>
               <sch:latestSalary/>
               <sch:person>
                  <sch:age>50</sch:age>
                  <sch:fullName>Yaroslav Y. Golko</sch:fullName>
                  <sch:firstName>Yaroslav</sch:firstName>
                  <sch:lastName>Golko</sch:lastName>
                  <sch:middleName>Y.</sch:middleName>
                  <sch:prefix>Mr.</sch:prefix>
                  <sch:suffix/>
               </sch:person>
               <sch:contact/>
               <sch:connectMail>
                  <sch:connectMailNameSource>false</sch:connectMailNameSource>
                  <sch:connectMailEmailSource>false</sch:connectMailEmailSource>
                  <sch:connectMailPhoneSource>false</sch:connectMailPhoneSource>
                  <sch:connectMailSource>None</sch:connectMailSource>
               </sch:connectMail>
               <sch:latestPosition>
                  <sch:title>Member, Management Committee; Head, Investment and Construction Department</sch:title>
                  <sch:jobFunction>
                     <sch:jobFunctionId>10</sch:jobFunctionId>
                     <sch:jobFunctionId>20</sch:jobFunctionId>
                     <sch:jobFunctionId>30</sch:jobFunctionId>
                  </sch:jobFunction>
                  <sch:startYear>2008</sch:startYear>
                  <sch:endYear>Present</sch:endYear>
                  <sch:titleText/>
               </sch:latestPosition>
               <sch:companyId>52477000000000</sch:companyId>
               <sch:duns>644903627</sch:duns>
               <sch:primaryCompanyPhone>495-719-30-01</sch:primaryCompanyPhone>
               <sch:biography>Member of Gazprom's Management Committee, Head of Investment & Construction Department  Date of Birth: August 22, 1961 Place of Birth: Volitsy village, Nesterov District, the Lvov Region Education: Higher Graduated from: Leningrad Mining University (1986), University of Marxism-Leninism under the Leningrad Regional Committee of the CPSU (1989) Academic title: Candidate Doctor in Economics Corresponding Member with the Russian Academy of Technological Sciences Business career: Before entering the University Mr. Yaroslav Golko worked at Mine &#8470; 3 VZH of the Lvov-Volynsk Coal Basin. 1981?1986, student of the Plekhanov Leningrad Mining University, simultaneously worked in various companies in the Leningrad city. 1986?1989, UNR-308 Spetstonnelstroy, Leningrad. 1989?1990, Deputy Chairman, Construction Cooperative 'Vertical'. 1990?2003, Deputy Director for Construction; Director; Director General, small state company ZAO Stiks. Since 2003 ? Director General, OOO Gaztaged. 2003?2005, Deputy Head of the Directorate of Accounting, Analysis and Corporate Policy, Asset Management and Corporate Relations Department, Gazprom. 2005?2006, First Deputy Head, Investment & Construction Department, Gazprom. Since November 2006 ? up-to-date, Head, Investment & Construction Department, Gazprom. Since January 2007 ? Member of Gazprom's Management Committee, Head of Investment & Construction Department, OAO Gazprom. Mr.Golko enjoys classic wrestling, hunting and fishing. Mr.Golko is married and has two children.</sch:biography>
               <sch:biographySource>Company Web Site</sch:biographySource>
               <sch:positionHistory/>
               <sch:salaryHistory/>
               <sch:socialMediaData/>
            </sch:official>
         </sch:return>
      </sch:GetPersonDetailResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>