Sorry, we didn't find any relevant articles for you.
Please fill out the contact form below and we will reply as soon as possible.
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?
Person Detail input parameter descriptions are grouped as follows:
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:
|
||
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:
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. |
The following example shows a Person Detail query. The input parameter includes:
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&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 & 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&targetid=profile</zoomCompanyUrl> <companyDetailXmlUrl>https://partnerapi.zoominfo.com/partnerapi/v4/company/detail?CompanyID=42483953&pc=ZoomTestQA&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&targetid=profile</zoomCompanyUrl> <companyDetailXmlUrl>https://partnerapi.zoominfo.com/partnerapi/v4/company/detail?CompanyID=42483953&pc=ZoomTestQA&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>
Person Detail output parameter descriptions are grouped as follows:
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 |
Contact our award-winning customer care team.