Person Detail

Person Detail returns a wide array of person-specific information for each unique identifier passed. Person summary data includes name, current position, management level, past position, education history, contact information, web references, etc. Your level of access rights will determine the amount of data returned. The HTTP request for Person Detail begins with the URL structure:

http://partnerapi.zoominfo.com/partnerapi/person/detail?

Input Parameters – Person Detail

Person Detail input parameter descriptions are grouped as follows:

  • Group - The grouping for search field permissions.
  • Field Name - Name of input parameter.
  • Required - Denotes whether or not a query requires the field.
  • Value - Valid values for the input parameter.
  • Notes - Information related to the input parameter.
  • Key - Denotes whether or not this field is used in key generation. The order in which the parameters appear in the table is the order in which you should use them in the key.


Group
Field Name
Required
Value
Notes
Key
Default
pc
required
 Partner code (name) assigned to you
no
outputType
optional
xml or json
The output format type of the response. Case insensitive.
no
outputFieldOptions
optional
 Person Detail Query has the following optional output fields:
  • jobFunction
  • managementLevel
  • companyTopLevelIndustry
  • companyLogo
  • localAddress
  • companyType
  • hasCanadianEmail
  • nameSuffix
  • gender 
  • companyHashtags
  • orderHashtags
  • techAttributes
To return one or more of these fields, specify the above output field name(s). To return multiple optional output fields, separate the values with a comma. For example, "outputFieldOptions=jobFunction,managementLevel" will return jobFunction and managementLevel in the output.
no
key
required

String consisting of 5 parameters concatenated together, and then encrypted with MD5. Parameters are:
 1) First two characters of PersonID (query dependent) and first two characters of EmailAddress (query dependent)
 2) your partner password
 3) today's day (not padded with zero)
 4) today's month (not padded with zero)
 5) today's year (4 digit)
no
PersonID or EmailAddress
PersonID
optional

Unique identifier for a person in the ZoomInfo database
yes
EmailAddress
optional

Person's email address in example@example.com format. If both PersonID and EmailAddress are provided, then EmailAddress is ignored.
yes


Example Person Detail Query

The following example shows a Person Detail query. The input parameter includes:

  • 457877 for PersonID

The Person Detail query request should be structured as follows:

http://partnerapi.zoominfo.com/partnerapi/person/detail?pc=PartnerCode&PersonID=457877&key=EncryptedKey

The Person Detail XML output would appear as follows:

<PersonDetailRequest
 xmlns="http://partnerapi.zoominfo.com/partnerapistatic/xsd/V1/PersonDetail.xsd">
 <PersonID>457877</PersonID>
 <ZoomPersonUrl> http://www.zoominfo.com/#!search/profile/person?personId=457877&
 targetid=profile </ZoomPersonUrl>
 <LastUpdatedDate>2014-06-16</LastUpdatedDate>
 <IsUserPosted>true</IsUserPosted>
 <ImageUrl> http://www.zoominfo.com/business/images/stories/managementteam/yonatan-stern-photo.jpg </ImageUrl>
 <FirstName>Jonathan</FirstName>
 <LastName>Stern</LastName>
 <Email>example@example.com</Email>
<CompanyPhone>(555)
 555-7500</CompanyPhone>
 <CurrentEmployment>
 <JobTitle>Founder and Chief Executive Officer</JobTitle>
 <Company> <CompanyID>344589814</CompanyID> <ZoomCompanyUrl> http://www.zoominfo.com/#!search/profile/company?companyId=344589814&targetid=profile </ZoomCompanyUrl> <CompanyDetailXmlUrl> http://partnerapi.zoominfo.com/partnerapi/company/detail?query_type=company_detail&CompanyID=344589814&pc=PartnerCode&key=EncryptedKey </CompanyDetailXmlUrl> <CompanyName>Zoom Information, Inc.</CompanyName> <Phone>(555) 555-7500</Phone> <Fax>(555) 555-7000</Fax> <Website>www.zoominfo.com</Website> <CompanyAddress> <Street>307 Waverley Oaks Rd.</Street> <City>Waltham</City> <State>Massachusetts</State> <Zip>02452</Zip> <CountryCode>United States</CountryCode> </CompanyAddress>
 </Company>
 </CurrentEmployment>
 <PastEmployment>
 <JobTitle>Founder and Chief Executive Officer</JobTitle>
 <Company> <CompanyID>6750984</CompanyID> <ZoomCompanyUrl> http://www.zoominfo.com/#!search/profile/company?companyId=6750984&targetid=profile </ZoomCompanyUrl> <CompanyDetailXmlUrl> http://partnerapi.zoominfo.com/partnerapi/company/detail?query_type= company_detail&CompanyID=6750984&pc=PartnerCode&key=EncryptedKey </CompanyDetailXmlUrl> <CompanyName>CardScan Inc</CompanyName> <Website>www.cardscan.com</Website> <CompanyAddress> <City>Cambridge</City> <State>Massachusetts</State> <CountryCode>United States</CountryCode> </CompanyAddress>
 </Company>
 </PastEmployment>
 ...
<Industry>Software & Technical
 Consulting</Industry>
 <Industry>Search Engines & Internet
 Portals</Industry>
 <Industry>Customer Relationship Management (CRM)
 Software</Industry>
 <WebReference>
<Title>Leadership | ZoomInfo</Title>
 http://www.zoominfo.com/business/about/leadership
 <Description> Jonathan Stern Yonatan Stern Founder, CEO & Chief Scientist Yonatan Stern Founder, CEO & Chief Scientist, ZoomInfo </Description>
 <Date>2014-06-04</Date>
 </WebReference>
 <WebReference>
 <Url> http://www.kipling.thefreelibrary.com/SALES+LEAD+MANAGEMENT+ASSOCIATION+HONORS+ZOOMINFO+VP+OF+MARKETING.-a0363482177 </Url>
 <Description> "Nir and her team's contributions have significantly impacted ZoomInfo's revenue growth and bottom line," said Yonatan Stern, ZoomInfo's founder, CEO(1) (Chief Executive Officer) The highest individual in command of an organization. </Description>
 <Date>2014-04-01</Date>
 </WebReference>
 <WebReference>
<Title>The Bizo Executive Team |
 Bizo</Title>
 http://www.bizo.com/about/team
 <Description> Yonatan Stern, Founder and Director Yonatan co-founded Bizo and led the charge to spin it out of ZoomInfo to create his fourth company in the last 20 years. Yonatan is currently the founder, CEO and Chief Scientist of ZoomInfo and is ... </Description>
 <Date>2013-12-10</Date>
 </WebReference>
 <WebReference>
 <Title>Yonatan Stern | ZoomInfo</Title>
 <Url> http://www.zoominfo.com/business/about/leadership/yonatan-stern </Url>
 <Description> Yonatan Stern Founder, Chief Executive Officer & Chief Scientist Yonatan Stern founded ZoomInfo (formerly Eliyon Technologies Corporation) in 2000 and is its chief executive officer and chief scientist. For more than 30 years, Stern has been active in cognitive science research, developing useful products based on algorithms which track the way people reason... </Description>
 <Date>2013-05-08</Date>
 </WebReference>
 <WebReference>
 <Title>Our Company | ZoomInfo</Title>
 <Url> http://www.zoominfo.com/business/about/our-company?utm_source=zoominfo.com&utm_medium=navigation&utm_content=our-company&utm_campaign=navigation_links </Url>
 <Description>Yonatan Stern</Description>
 <Date>2014-06-04</Date>
 </WebReference>
 ...
<SummaryStatistics>
 <WebReferences>587</WebReferences>
 </SummaryStatistics>
</PersonDetailRequest>

Output Parameters – Person Detail

Person Detail output parameter descriptions are grouped as follows:

  • Group - Grouping for output field permissions. The permission groups configured for a partner determine the output fields present in a response.
  • Parent Name - Name of output element.
  • Child Name - Name of a child element of a parent element specified in the parent name column.
  • Notes - Information related to the output field.


Group
Parent Name
Child Name
Notes
Default
PersonID

Unique identifier for the person
ZoomPersonURL

Link to person's ZoomInfo.com public profile
LastUpdatedDate

Date of the last time the person's profile was updated
IsUserPosted

Designates if a profile was manually built by the person. true = manually created, false = crawled by ZoomInfo
ImageUrl

The URL to the person's profile image
Name
FirstName

First name of the person
MiddleInitial

Middle Initial of the person
LastName

Last name of the person
Email
Email

Email for the person in example@example.com format
Phone Numbers
DirectPhone

The person's direct phone number, if available
CompanyPhone

Main phone number for the person's current employment company
Current Employment
CurrentEmployment

Current company the person is employed with. CurrentEmployment contains child elements.
JobTitle
Person's title at their current place of employment
JobFunction
Person's job function at their current place of employment
Optional:This output field won't be shown unless the 'outputFieldOptions' parameter contains this output field
ManagementLevel
Person's management level at their current place of employment
Optional:This output field won't be shown unless the 'outputFieldOptions' parameter contains this output field
FromDate
Start date of the person's current employment.
Company

Contains the child elements with information about the person's current company of employment
CompanyID
The unique identifier used by ZoomInfo for companies
ZoomCompanyUrl
Link to the company's ZoomInfo.com public profile
CompanyDetailXmlUrl
API request URL for Company Detail. Returned output will be in XML format
CompanyName
Name of the company
Phone
Primary phone number of the company
Fax
Fax number of the company
WebsiteThe URL to the company website in http://www.example.com format
CompanyLogo
The URL which can be used to retrieve the logo for the company.”  This should NOT be added to the “Past Employment” element.
CompanyAddress

Contains child elements with the company's address
Street
Street of the company's primary address
City
City of the company's primary address
State
State of the company's primary address
Zip
Zip code of the primary address
Country Code
Country code of the primary address
Past Employment
PastEmployment

Companies that have employed the person in the past. Multiple companies for employment history are allowed.
JobTitle
The person's title at a past place of employment
FromDate
Start date of the person's past employment
ToDate
End date of the person's past employment
Company

Contains the child elements with information about the person's past company of employment
CompanyID
Unique identifier used by ZoomInfo for the company
ZoomCompanyUrl
The URL to the company profile on zoominfo.com public site
CompanyDetailXmlUrl
API request URL for Company Detail. Returned output will be in XML format
CompanyName
Name of the company
Phone
Primary phone number of the company
Website
The URL to the company website in http://www.example.com format
CompanyAddress

Contains child elements with the company's address
Street
Street of the company's primary address
City
City of the company's primary address
State
State of the company's primary address
Zip
Zip code of the company's primary address
CountryCode
Country code of the company's primary address.
Education
Education

Education information for the person. Multiple educations are allowed for a person.
School
Name of the school where the person received a degree
GraduationDate
Year the person received a degree from the school
EducationDegree

Contains child elements describing the type of degree the person received from the school. A person can have more than one EducationDegreefrom the same school.
Degree
Type of degree the person received (BA, MBA, etc)
AreaOfStudy
Area of study (a person's major or minor) ex: Biology, Business Administration
Industries  
TopLevelIndustry
Top Level (and therefore least specific) Industry that the person works in. A person can have multiple top level industries.  Top level industry tags are based on the current employment company. Optional:This output field won't be shown unless the 'outputFieldOptions' parameter contains “companyTopLevelIndustry”
Industry

Industry the person currently works in. A person can have multiple industries. Industry tags are based on the current employment company.
Board Memberships
Affiliation

A part time position that somebody holds. Usually affiliated with associations or board memberships. Affiliation contains child elements
JobTitle
Title of person's affiliation. Common values: Board Member, Treasurer
JobFunction
Job function of person's affiliation
Optional:This output field won't be shown unless the 'outputFieldOptions' parameter contains this output field
ManagementLevel
Management level of person's affiliation
Optional:This output field won't be shown unless the 'outputFieldOptions' parameter contains this output field
FromDate
Start date of the person's affiliation
ToDate
End date of the person's affiliation
Company

Contains the child elements with information about the person's company of employment
CompanyID
The unique identifier used by ZoomInfo for the company
ZoomCompanyUrl
The URL to the company profile on zoominfo.com public site
CompanyDetailXmlUrl
API request URL for Company Detail. Returned output will be in XML format
CompanyName
Name of the company
Phone
Primary phone number of the company
Website
The URL to the company website in http://www.example.com format
CompanyAddress

Contains child elements describing the company's primary address
Street
Street of the company's primary address
City
City of the company's primary address
State
State of the company's primary address
Zip

Zip code of the company's primary address

Country Code

Country code of the company's primary address


Certifications
Certifications

Describes an accreditation received by an organization. ( CPA, Registered Nurse, etc) Certificationscontains 3 child elements
CertificationName
Name or type of certification the person has received
OrganizationName
Certifying organization
YearReceived
Year the person received the certification
Biography
Biography

A person entered summary about themselves. Only available for summaries that are manually created.
Web References
WebReference

Source document where the information was extracted. WebReferencecontains three child elements
Title
The title of the web source
URL
The URL to the web reference
Description
Text from the web reference where ZoomInfo crawlers found information about the company or person
Date
Date that we found the web reference
Statistics
SummaryStatistics

An overview of statistics gathered on a person's public zoominfo.com profile. SummaryStatisticscontains a child element.
WebReferences
Number of web references found on a person

Was this article helpful?

Can’t find what you’re looking for?

Contact our award-winning customer care team.