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
PersonID or EmailAddress	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

Person Detail

Input Parameters – Person Detail

Example Person Detail Query

Output Parameters – Person Detail

Quick Jump

Can’t find what you’re looking for?