AdvancedCompanySearch

Advanced Person Search

Overview

Returns search result of companies based on various criteria. Formerly known as the Build A List (BAL) Service.

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>