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:

https://partnerapi.zoominfo.com/partnerapi/v4/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.
Group
 Field Name
 Required
 Value
 Notes
Default
 pc
 required
   Partner code (name) assigned to you
outputType
 optional
 xml or json
 The output format type of the response. Case insensitive.
outputFieldOptions
 optional
   Person Detail Query has the following optional output fields:
  • jobFunction
  • managementLevel
  • companyTopLevelIndustry
  • companyLogo
  • localAddress
  • companyType
  • companyDescription
  • companyTicker
  • companysic
  • companynaics
  • lowestSICSonly
  • lowestNAICSonly
  • hasCanadianEmail
  • nameSuffix
  • gender 
  • companyHashtags
  • orderHashtags
  • techAttributes
  • isEU
  • continent
  • isdefunct
  • socialUrls
  • numericFull
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.
techAttributesToOutput
 optional

This input is used to specify which technologies are returned from techAttributes. Be sure to use in conjunction with techAttributes in outputFieldOptions. 

Exact tags represent techAttribute products and wild carded values represent multiple products. Accepts multiple values by passing a comma-separated list. Values can be entered in any of the following formats:

1) Product (Search for people who work at companies which use this technology product)
2) ParentCategory.Category.Vendor.* (Search for people who work at companies which use products under specified ParentCategory, Category and Vendor)
3) ParentCategory.Category.* (Search for people who work at companies which use products under specified ParentCategory, Category)
4) *.Vendor.* (Search for people who work at companies which use products under specified Vendor)


Examples:

6356

332.7.11831.*, 332.7.*,6356

*.11831.*, 6356
key
 required
OAuth access token returned from the OAuth token request:   https://partnerapi.zoominfo.com/partnerapi/v2/token
PersonID or EmailAddress
 PersonID
 optional
Unique identifier for a person in the ZoomInfo database
EmailAddress
 optional
Person's email address in example@example.com format. If both PersonID and EmailAddress are provided, then EmailAddress is ignored.


Example Person Detail Query

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

  • 1981501294 for PersonID

The Person Detail query request should be structured as follows:

https://partnerapi.zoominfo.com/partnerapi/v4/person/detail?pc=PartnerCode&PersonID=1981501294&key=OAuthAccessToken

The Person Detail XML output would appear as follows:

<?xml version="1.0" encoding="UTF-8"?>
<personDetailResponse xmlns="http://partnerapi.zoominfo.com/partnerapistatic/xsd/V4">
   <personId>1981501294</personId>
   <zoomPersonUrl>http://www.zoominfo.com/s/#!search/profile/person?personId=1981501294&amp;targetid=profile</zoomPersonUrl>
   <firstName>John</firstName>
   <lastName>Borthwick</lastName>
   <lastUpdatedDate>2018-05-04</lastUpdatedDate>
   <isUserPosted>false</isUserPosted>
   <industry>Television Stations</industry>
   <industry>Broadcasting</industry>
   <industry>Media &amp; Internet</industry>
   <companyPhone>(646) 829-4400</companyPhone>
   <currentEmployment>
      <jobTitle>Chief Executive Officer and President, Betaworks</jobTitle>
      <fromDate>2016-05-04-04:00</fromDate>
      <toDate>2018-05-04Z</toDate>
      <company>
         <companyId>42483953</companyId>
         <zoomCompanyUrl>http://www.zoominfo.com/s/#!search/profile/company?companyId=42483953&amp;targetid=profile</zoomCompanyUrl>
         <companyDetailXmlUrl>https://partnerapi.zoominfo.com/partnerapi/v4/company/detail?CompanyID=42483953&amp;pc=ZoomTestQA&amp;key=4653d9b6-ace3-44b9-ad3c-f90606597817</companyDetailXmlUrl>
         <companyName>WNYC</companyName>
         <companyPhone>(646) 829-4400</companyPhone>
         <companyWebsite>www.wnyc.org</companyWebsite>
         <companyAddress>
            <street>160 Varick Street</street>
            <city>New York City</city>
            <state>New York</state>
            <zip>10013</zip>
            <country>United States</country>
         </companyAddress>
         <companyEmployeeCount>375</companyEmployeeCount>
         <companyEmployeeCountRange>250 - 500</companyEmployeeCountRange>
      </company>
   </currentEmployment>
   <education>
      <school>Wharton</school>
      <graduationDate>1994-01-01-05:00</graduationDate>
      <educationDegree>
         <degree>MBA</degree>
         <areaOfStudy />
      </educationDegree>
   </education>
   <education>
      <school>Wesleyan University</school>
      <graduationDate>1987-01-01-05:00</graduationDate>
      <educationDegree>
         <degree>undergraduate degree BA</degree>
         <areaOfStudy>Economics</areaOfStudy>
      </educationDegree>
   </education>
   <affiliation>
      <jobTitle>Chief Executive Officer and President, Betaworks</jobTitle>
      <fromDate>2016-05-04-04:00</fromDate>
      <toDate>2018-05-04Z</toDate>
      <company>
         <companyId>42483953</companyId>
         <zoomCompanyUrl>http://www.zoominfo.com/s/#!search/profile/company?companyId=42483953&amp;targetid=profile</zoomCompanyUrl>
         <companyDetailXmlUrl>https://partnerapi.zoominfo.com/partnerapi/v4/company/detail?CompanyID=42483953&amp;pc=ZoomTestQA&amp;key=4653d9b6-ace3-44b9-ad3c-f90606597817</companyDetailXmlUrl>
         <companyName>WNYC</companyName>
         <companyPhone>(646) 829-4400</companyPhone>
         <companyWebsite>www.wnyc.org</companyWebsite>
         <companyAddress>
            <street>160 Varick Street</street>
            <city>New York City</city>
            <state>New York</state>
            <zip>10013</zip>
            <country>United States</country>
         </companyAddress>
         <companyEmployeeCount>375</companyEmployeeCount>
         <companyEmployeeCountRange>250 - 500</companyEmployeeCountRange>
      </company>
   </affiliation>
   <webReference>
      <title>Leadership - NEW YORK PUBLIC RADIO ANNUAL REPORT FY16</title>
      <url>https://fy16annualreport.nypublicradio.org/leadership</url>
      <description>John Borthwick
CEO and President, betaworks</description>
      <date>2018-05-04Z</date>
   </webReference>
   <webReference>
      <title>Board of Trustees</title>
      <url>http://wnyc.demo2.wnyc.net/about/board/</url>
      <description>John Borthwick</description>
      <date>2016-10-14</date>
   </webReference>
   <webReference>
      <title>Meet your Disrupt NY Startup Battlefield final round judges: John Borthwick, Charles Hudson, Alfred Lin, Susan Lyne, Matthew Panzarino and Alan Patricof | TechCrunch</title>
      <url>http://feedproxy.google.com/~r/Techcrunch/~3/IjdtbcBMvvg/</url>
      <description>John Borthwick, Naveen Selvadurai, and Heather Hartnett to school us on startup studios at TC Disrupt NY
 
John Borthwick, Naveen Selvadurai, and Heather Hartnett to school us on startup studios at TC Disrupt NY
 
John Borthwick, Naveen Selvadurai, and Heather Hartnett to school us on startup studios at TC Disrupt NY
 
John Borthwick, Naveen Selvadurai, and Heather Hartnett to school us on startup studios at TC Disrupt NY
 
Meet your Disrupt NY Startup Battlefield final round judges: John Borthwick, Charles Hudson, Alfred Lin, Susan Lyne, Matthew Panzarino and Alan Patricof
 
John Borthwick is the CEO and co-founder of betaworks.
Betaworks is an internet studio that builds and invests in companies across the social, data-driven media internet.
 
Companies that betaworks has built include Giphy, Dots, bitly and Chartbeat, betaworks acquired and re-launched Digg and Instapaper.
Betaworks investments include: kickstarter, tumblr (acquired by Yahoo), Summize (acquired by Twitter as their search engine), IFTTT, OMG Pop (acquired by Zynga), Tweetdeck (acquired by Twitter), along with 100+ others.
 
Prior to betaworks John was Senior Vice President of Alliances and Technology Strategy for Time Warner Inc.
John's company, WP-Studio, founded in 1994, was one of the first content studios in New York's Silicon Alley, it was acquired by AOLTW.
John holds an MBA from Wharton (1994) and an undergraduate degree BA in Economics from Wesleyan University (1987).
He sits on the board of WNYC, Data and Society, and Rhizome at the New Museum.</description>
      <date>2016-05-04-04:00</date>
   </webReference>
   <webReference>
      <title>Digital Innovation - NEW YORK PUBLIC RADIO ANNUAL REPORT FY16</title>
      <url>https://fy16annualreport.nypublicradio.org/digital</url>
      <description>John Borthwick* , Co-Chair
CEO and Co-Founder</description>
   </webReference>
   <webReference>
      <title>Innovation - NEW YORK PUBLIC RADIO ANNUAL REPORT FY15</title>
      <url>http://fy15annualreport.nypublicradio.org/innovation/</url>
      <description>John Borthwick*, Co-Chair
CEO and President</description>
   </webReference>
   <summaryStatistics>
      <webReferences>6</webReferences>
   </summaryStatistics>
</personDetailResponse>

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 Address
 EmailAddress
Email Address 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
Website The 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?

Quick Jump

Can’t find what you’re looking for?

Contact our award-winning customer care team.

Contact Support

Your new customer care experience is waiting for you

Which platform do you use?