AdvancedPersonSearch

Advanced Person Search

Overview

Returns search result of people based on various different criteria

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>