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\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\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\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