Hoover's API Version 4.0 - Person
Queries - SOAP - Person Information
IMPORTANT: All calls on this page require an API key
New features are highlighted.
1 Find Person By Keyword Search
1.1 Overview
Returns search result of people based on keyword. The keyword should be a person's name or part of a name.
1.2 Input Parameters
Required fields are indicated with.
Field Name | Value | Notes |
keyword | String containing a keyword. Keyword should be a name of a person or part of a name | |
dunsFrom | Long | Search for Duns number starting from this value |
dunsTo | Long | Search for Duns number ending this value |
nonMarketableCompanyFilterOptions | Object | This object has filter parameters to search for non marketable companies |
nonMarketableCompanyFilterOptions\includeUndeliverableAddress | boolean | set the value to true, if you need to search the companies which has no proper address |
nonMarketableCompanyFilterOptions\includeOutOfBusiness | boolean | set the value to true, if you need to search the companies which are out of business |
nonMarketableCompanyFilterOptions\includeIncompleteData | boolean | set the value to true, if you need to search the companies which doesnt have key company information |
maxRecords | Between 1-200. Default = 20 | |
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. |
sortDirection | Values defined in WSDL: sortDirectionTypes - Ascending or Descending | This has no effect without a valid orderBy. |
orderBy | Values defined in WSDL, orderByTypes | Default order by is relevance. Other values for this search include:
|
returnSearchNavigation | 'true' or 'false' | If true navigators will be returned in the response to enable drill down into search results |
\searchNavigation\ jobFunctionSearchNavigation\ jobFunctionSearchNavigationValue | A job function navigation link which can be fed back into other calls. | The job function navigation link must be used to drill down by number of people with that job. |
\searchNavigation\ locationSearchNavigation\ countryNavigation\ countryNavigationValue | A country navigation link which can be fed back into other calls. | The country navigation link must be used to drill down by country. |
\searchNavigation\ locationSearchNavigation\ countryNavigation\ stateNavigation\ stateNavigationValue | A state/province navigation link which can be fed back into other calls. | The state/province navigation link must be used to drill down by state/province. |
\searchNavigation\ locationSearchNavigation\ countryNavigation\ stateNavigation\ cityNavigation\ cityNavigationValue | A city navigation link which can be fed back into other calls. | The city navigation link must be used to drill down by city. |
searchNavigation/ industrySearchNavigation/ industrySearchNavigationValue | A industry navigation link which can be fed back into other calls. | The industry navigation link must be used to drill down by industry. |
searchNavigation/ industrySearchNavigation/ ussicSearchNavigationValue | A UsSIC navigation link which can be fed back into other calls. | The UsSIC navigation link must be used to drill down by UsSIC. |
searchNavigation/ industrySearchNavigation/ naicsSearchNavigationValue | A NaICS navigation link which can be fed back into other calls. | The NaICS navigation link must be used to drill down by NaICS. |
1.3 Output Parameters
Field Name | Value | Notes |
\return\resultSet\firstHit | First Hit | |
\return\resultSet\hit\coOfficialResults\coOfficialId | Hoovers Official ID | |
\return\resultSet\hit\coOfficialResults\companyId | Hoovers Company ID | |
\return\resultSet\hit\coOfficialResults\nonMarketableCompany | Object | This object contains child tags representing the reasons for which this company is taged as non-marketable. |
\return\resultSet\hit\coOfficialResults\nonMarketableCompany\reason | String value | The possible reasons are
|
\return\resultSet\hit\coOfficialResults\duns | DUNS | |
\return\resultSet\hit\coOfficialResults\firstName | Person First Name | |
\return\resultSet\hit\coOfficialResults\lastName | Person Last Name | |
\return\resultSet\hit\coOfficialResults\middleName | Person Middle Name | |
\return\resultSet\hit\coOfficialResults\suffix | Person Suffix | |
\return\resultSet\hit\coOfficialResults\title | Person Title | |
\return\resultSet\hit\coOfficialResults\companyName | Company Name | |
\return\resultSet\hit\coOfficialResults\connectMail | Wrapper element for ConnectMail indicators | |
\return\resultSet\hit\coOfficialResults\connectMail\connectMailNameSource | Indicates if official's name is a ConnectMail contact | |
\return\resultSet\hit\coOfficialResults\connectMail\connectMailEmailSource | Indicates if official's email is a ConnectMail contact | |
\return\resultSet\hit\coOfficialResults\connectMail\connectMailPhoneSource | Indicates if official's phone number is a ConnectMail contact | |
\return\resultSet\hit\coOfficialResults\connectMail\connectMailSource | Indicates ConnectMail source | |
\return\resultSet\hit\hitNumber | Hit Number | |
\return\resultSet\hits | Total Number of Hits in this Response | |
\return\resultSet\lastHit | Last Hit | |
\return\resultSet\totalHits | Aggregate Total Number of Hits | This is the total number of results the search returned |
\return\navigators | Contains lists of navigation links | The values in the navigation link lists must be fed back into other calls with the same keyword |
\return\navigators\jobFunctionNavigators\jobFunctionNavigator\jobFunctionNavigatorValue | The value of a navigation link for job functions | To drill down on job functions a value from this element must be fed back into another call with the same keyword. |
\return\navigators\jobFunctionNavigators\jobFunctionNavigator\jobFunctionNavigatorDescription | The description of a navigation link for job functions | Could be used as a display value for the link |
\return\navigators\locationNavigators\countryNavigators\countryNavigator\countryNavigatorValue | The value of a navigation link for country | To drill down on country a value from this element must be fed back into another call with the same keyword. |
\return\navigators\locationNavigators\countryNavigators\countryNavigator\countryNavigatorDescription | The description of a navigation link for country description | Could be used as a display value for the link |
\return\navigators\locationNavigators\countryNavigators\countryNavigator\stateProvinceNavigators\stateProvinceNavigator\stateProvinceNavigatorValue | The value of a navigation link for state/province | To drill down on state/province a value from this element must be fed back into another call with the same keyword. |
\return\navigators\locationNavigators\countryNavigators\countryNavigator\stateProvinceNavigators\stateProvinceNavigator\stateProvinceNavigatorDescription | The description of a navigation link for state/province description | Could be used as a display value for the link |
\return\navigators\locationNavigators\countryNavigators\countryNavigator\stateProvinceNavigators\stateProvinceNavigator\cityNavigators\cityNavigator\cityNavigatorValue | The value of a navigation link for city | To drill down on city a value from this element must be fed back into another call with the same keyword. |
\return\navigators\locationNavigators\countryNavigators\countryNavigator\stateProvinceNavigators\stateProvinceNavigator\cityNavigators\cityNavigator\cityNavigatorDescription | The description of a navigation link for city description | Could be used as a display value for the link |
\return\navigators\industryNavigators\industryNavigator\industryNavigatorValue | The value of a navigation link for industry | To drill down on industry a value from this element must be fed back into another call with the same keyword. |
\return\navigators\industryNavigators\industryNavigator\industryNavigatorDescription | The description of a navigation link for industry | Could be used as a display value for the link |
\return\navigators\industryNavigators\ussicNavigator\ussicNavigatorValue | The value of a navigation link for UsSIC | To drill down on UsSIC a value from this element must be fed back into another call with the same keyword. |
\return\navigators\industryNavigators\ussicNavigator\ussicNavigatorDescription | The description of a navigation link for UsSIC | Could be used as a display value for the link |
\return\navigators\industryNavigators\naicsNavigator\naicsNavigatorValue | The value of a navigation link for NaICS | To drill down on NaICS a value from this element must be fed back into another call with the same keyword. |
\return\navigators\industryNavigators\naicsNavigator\naicsNavigatorDescription | The description of a navigation link for NaICS | Could be used as a display value for the link |
2 Advanced Person Search
2.1 Overview
Returns search result of people based on various different criteria
2.2 Input Parameters
Required fields are indicated with.
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, BaseOrderByTypes | |
\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\location | 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 | Set the value to true for searching Franchise and false to Not a Franchise | |
\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 | MM/DD/YYYY | |
\bal\financialdata\tradingDateTo | Trading Date Upper Bound | MM/DD/YYYY | |
\bal\financialdata\underwriterId | Underwriters | ID Value from GetAdvancedSearchLookups It searches only the lead underwriter for the given underwriterId. | |
\bal\industry\hooversIndustryCode | Hoovers 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, 512, 212 | |
\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" or Separate multiple ZIP codes by commas. | |
\bal\usZipCodeRange\from | US ZIP Code Lower Bound | ||
\bal\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\dunsFrom | DUNS Number from which the search result has to be listed | eg: 1005003 | |
\bal\specialtyCriteria\dunsTo | DUNS Number up to which the search result has to be listed | eg: 1005006 | |
\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. 4044056 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 | |
\bal\people\lastName | Person Last Name | ||
\bal\people\firstName | Person First Name | ||
\bal\people\ageFrom | Person Age Lower Bound | ||
\bal\people\ageTo | Person Age Upper Bound | ||
\bal\people\bonusFrom | Person Bonus ($) Lower Bound | ||
\bal\people\bonusTo | Person Bonus ($) Upper Bound | ||
\bal\people\jobFunctionId | Person Job Function ID | ID Value from GetAdvancedSearchLookups. | |
\bal\people\keywordsIn | Keywords In | Title or Bio | |
\bal\people\keywordSelect | Person Keyword | e.g. marketing or Harvard or ad sales | |
\bal\people\salaryFrom | Person Salary ($) Lower Bound | ||
\bal\people\salaryTo | Person Salary ($) Upper Bound | ||
\bal\people\totalPayFrom | Person Total Pay ($) Lower Bound | ||
\bal\people\totalPayTo | Person Total Pay ($) Upper Bound |
2.3 Output Parameters
Field Name | Value | Notes |
\return\people\firstHit | First Hit | |
\return\people\hit\coOfficialResults\coOfficialId | Hoovers Official ID | |
\return\people\hit\coOfficialResults\companyId | Hoovers Company ID | |
\return\people\hit\coOfficialResults\duns | DUNS | |
\return\people\hit\coOfficialResults\fullName | Person Full Name | |
\return\people\hit\coOfficialResults\firstName | Person First Name | |
\return\people\hit\coOfficialResults\lastName | Person Last Name | |
\return\people\hit\coOfficialResults\middleName | Person Middle Name | |
\return\people\hit\coOfficialResults\suffix | Person Suffix | |
\return\people\hit\coOfficialResults\title | Person Title | |
\return\people\hit\coOfficialResults\companyName | Company Name | |
\return\resultSet\hit\coOfficialResults\connectMail | Wrapper element for ConnectMail indicators | |
\return\resultSet\hit\coOfficialResults\connectMail\connectMailNameSource | Indicates if official's name is a ConnectMail contact | |
\return\resultSet\hit\coOfficialResults\connectMail\connectMailEmailSource | Indicates if official's email is a ConnectMail contact | |
\return\resultSet\hit\coOfficialResults\connectMail\connectMailPhoneSource | Indicates if official's phone number is a ConnectMail contact | |
\return\resultSet\hit\coOfficialResults\connectMail\connectMailSource | Indicates ConnectMail source | |
\return\people\hit\hitNumber | Hit Number | |
\return\people\hits | Total Number of Hits in this Response | |
\return\people\lastHit | Last Hit | |
\return\people\totalHits | Aggregate Total Number of Hits | This is the total number of results the search returned |
3 Get Person Detail
3.1 Overview
Returns search result of detailed person information based on criteria of a Hoover's Official ID and Company ID.
When calling this service, ensure the Hoover's 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" Hoover's Official ID will cause either invalid or no results.
3.2 Input Parameters
Required fields are indicated with.
Field Name | Value | Notes |
coOfficialId | Hoovers Official ID | |
uniqueCompanyId | Hoover's Company ID or DUNS | |
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 |
3.3 Output Parameters
Field Name | Value | Notes |
\return\official\companyId | Hoovers Company ID | |
\return\official\duns | DUNS number | |
\return\official\primaryCompanyPhone | Primary phone number for the company | |
\return\official\coOfficialId | Hoovers Official ID | |
\return\official\currencyConvertedTo | Currency in which the latest salary is returned | Can be specified in the request using convertCurrencyTo element |
\return\official\nonMarketableCompany | Non Marketable company information Wrapper. This wrapper is displayed only if the company is non-marketable. | |
\return\official\nonMarketableCompany\reason | List of reasons why this company is non-marketable. | The possible values are 'Invalid address', 'Out of business', 'Key data missing/needing revision', 'Requested no marketing contact' |
\return\official\biography | Biographic Information | |
\return\official\biographySource | Biography Source Name | |
\return\official\contact | Official Contact Information Wrapper | |
\return\official\contact\phoneNumber | Contact phone number from ConnectMail | |
\return\official\contact\email | Contact email address from ConnectMail | |
\return\official\latestPosition | Most recent position information | |
\return\official\latestPosition\title | Person Title | |
\return\official\latestPosition\jobFunction\jobFunctionId | Job function id | List of Jobfunction ids |
\return\official\latestPosition\titleText | Latest position title text | |
\return\official\latestPosition\startYear | Latest position start year | |
\return\official\latestPosition\endYear | Latest position end year | |
\return\official\positionHistory | Collection on position elements (position history for the official) | |
\return\official\positionHistory\position\title | Person Title | |
\return\official\positionHistory\position\titleText | Latest position title text | |
\return\official\positionHistory\position\startYear | Position start year | |
\return\official\positionHistory\position\endYear | Position end year | |
\return\official\latestSalary | Most recent salary information | |
\return\official\latestSalary\year | Latest salary year | |
\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\salaryHistory | Collection of salary elements (salary history for the official) | |
\return\official\salaryHistory\salary\year | Salary Year | |
\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\person\fullName | Person Full Name | |
\return\official\person\lastName | Person Last Name | |
\return\official\person\firstName | Person First Name | |
\return\official\person\middleName | Person Middle Name | |
\return\official\person\suffix | Person Suffix | |
\return\official\person\prefix | Person Prefix | |
\return\official\person\age | Person Age | |
\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 |
4 Get Person Detail Simple
4.1 Overview
Returns a reduced subset of person details for a given Unique Official ID
4.2 Input Parameters
Required fields are indicated with.
Field Name | Value | Notes |
coOfficialId | Hoovers Official ID | |
uniqueCompanyId | Hoover's Company ID or DUNS | |
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 |
4.3 Output Parameters
Field Name | Value | Notes |
\return\official\coOfficialId | Hoovers Official ID | |
\return\official\currencyConvertedTo | Currency in which the latest salary is returned | Can be specified in the request using convertCurrencyTo element |
\return\official\latestPosition | Most recent position information | |
\return\official\latestPosition\title | Person Title | |
\return\official\latestPosition\jobFunction\jobFunctionId | Job function id | List of Jobfunction ids |
\return\official\latestPosition\startYear | Latest position start year | |
\return\official\latestPosition\endYear | Latest position end year | |
\return\official\latestSalary | Most recent salary information | |
\return\official\latestSalary\year | Latest salary year | |
\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\person\fullName | Person Full Name | |
\return\official\person\lastName | Person Last Name | |
\return\official\person\firstName | Person First Name | |
\return\official\person\middleName | Person Middle Name | |
\return\official\person\suffix | Person Suffix | |
\return\official\person\prefix | Person Prefix | |
\return\official\person\age | Person Age | |
\return\official\contact | Official Contact Information Wrapper | |
\return\official\contact\phoneNumber | Contact phone number from ConnectMail | |
\return\official\contact\email | 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\nonMarketableCompany | Non Marketable company information Wrapper. This wrapper is displayed only if the company is non-marketable. | |
\return\official\nonMarketableCompany\reason | List of reasons why this company is non-marketable. | The possible values are 'Invalid address', 'Out of business', 'Key data missing/needing revision', 'Requested no marketing contact' |
- Versions
- Version 3.0
- Version 3.1
- Version 3.2
- Version 3.3
- Version 3.4
- Version 4.0
- Version 4.0 Documentation
- Overview
- Security
- SOAP Services
- Queries - Company Information
- Queries - Person Information
- Queries - Industry Information
- Queries - Lookup Information
- Queries - Personalization
- REST Services
- Queries - Person Information