Company Detail

The Company Detail query returns a wide array of company specific information for each company unique identifier passed. The access rights set for partner account limit the data returned. The HTTPS request for Company Detail begins with the URL structure:

https://partnerapi.zoominfo.com/partnerapi/v4/company/detail?

Input Parameters – Company Detail

The table below shows input parameters that can be used in Company Detail queries. Parameter descriptions are grouped as follows:

  • Group - The grouping for search field permissions
  • Field Name - Name of the input parameter
  • Required - Denotes whether or not a query request requires the field
  • Value - Valid values for this input parameter
  • Notes - Information related to the input parameter


Group
Field Name
Required
Value
Notes
Default
pc
required

Partner code (name) assigned to you
key
required
 OAuth access token returned from the OAuth token request:   https://partnerapi.zoominfo.com/partnerapi/v4/token
outputType
optional
xml or json
The format type of the response content. Case insensitive.
includeKeyPerson
optional
true or false
Default value is false. When set to true, this optional parameter adds the KeyPerson element to the Company Detail output, but only if you have permission to the KeyPerson output field. Be aware that adding the KeyPerson element to the Company Detail output will result in slower performance for that Company Detail query. (See KeyPerson below in the Output Parameters.)
outputFieldOptions
optional
 
Company Detail Query has the following output field:
  • companyRevenueNumeric
  • companyRevenueRange
  • companyEmployeeRange
  • companyTopLevelIndustry
  • companyLogo
  • companyProductsAndServices
  • companyHashtags
  • acquiredByCompany
  • orderHashtags
  • companyType
  • techAttributes 
To return this field, specify the above output field name. For example, "outputFieldOptions=companyRevenueNumeric" will return Revenuein000s in the XML output
Company ID or Company Domain
CompanyID
cid or domain

The company's ZoomInfo ID
CompanyDomain
cid or domain

Company's website domain address. If you provided the CompanyDomain along with CompanyID, then we would ignore CompanyDomain.


Example Company Detail Query

The example below shows a Company Detail request with the following input parameters:

  • www.zoominfo.com for CompanyDomain

Here is the structure of the Company Detail query:

https://partnerapi.zoominfo.com/partnerapi/v4/company/detail?pc=PartnerCode&CompanyDomain=www.zoominfo.com&key=OAuthAccessToken

The Company Detail output appears in XML as follows:

<?xml version="1.0" encoding="UTF-8"?>
<companyDetailResponse xmlns="http://partnerapi.zoominfo.com/partnerapistatic/xsd/V4">
   <companyId>344589814</companyId>
   <zoomCompanyUrl>http://www.zoominfo.com/s/#!search/profile/company?companyId=344589814&amp;targetid=profile</zoomCompanyUrl>
   <companyName>Zoom Information, Inc.</companyName>
   <companyPhone>(781) 693-7500</companyPhone>
   <companyFax>(617) 507-8187</companyFax>
   <companyWebsite>www.zoominfo.com</companyWebsite>
   <companyAddress>
      <street>307 Waverley Oaks Rd. Suite 405</street>
      <city>Waltham</city>
      <state>Massachusetts</state>
      <zip>02452</zip>
      <country>United States</country>
   </companyAddress>
   <companyRevenue>$64.8 Million</companyRevenue>
   <companyEmployeeCount>210</companyEmployeeCount>
   <companySIC>27</companySIC>
   <companySIC>274</companySIC>
   <companySIC>2741</companySIC>
   <companySIC>7375</companySIC>
   <companySIC>737</companySIC>
   <companySIC>73</companySIC>
   <companySIC>731</companySIC>
   <companyNAICS>5418</companyNAICS>
   <companyNAICS>51711</companyNAICS>
   <companyNAICS>541</companyNAICS>
   <companyNAICS>517110</companyNAICS>
   <companyNAICS>5182</companyNAICS>
   <companyNAICS>51</companyNAICS>
   <companyNAICS>5171</companyNAICS>
   <companyNAICS>54</companyNAICS>
   <companyNAICS>518</companyNAICS>
   <companyNAICS>517</companyNAICS>
   <companyDescription>ZoomInfo is the most comprehensive source of business information on people and companies in the world.  ZoomInfo is used by sales and marketing professionals to find leads, recruiters to uncover talent and by business professionals to find detailed information on people and companies. ZoomInfo's semantic search engine gathers publicly-available information from the Business Web - millions of company websites, news feeds and other online sources - 24 hours a day, 7 days a week, then automatically compiles it into easy-to-search and easy-to-read profiles. ZoomInfo currently has profiles on more than 200 million people and 11 million companies, and its search engine adds over 20,000 new profiles monthly.</companyDescription>
   <companyIndustry>Search Engines &amp; Internet Portals</companyIndustry>
   <companyIndustry>Media &amp; Internet</companyIndustry>
   <companyIndustry>Advertising &amp; Marketing</companyIndustry>
   <companyIndustry>Business Services</companyIndustry>
   <companyIndustry>Publishing</companyIndustry>
   <otherCompanyAddress>
      <street>38 W. Fulton Street S.W Suite 313</street>
      <city>Grand Rapids</city>
      <state>Michigan</state>
      <zip>49503</zip>
      <country>United States</country>
   </otherCompanyAddress>
   <otherCompanyAddress>
      <street>HaSheizaf Street 4</street>
      <city>Ra'anana</city>
      <state>Central District</state>
      <zip>4366411</zip>
      <country>Israel</country>
   </otherCompanyAddress>
   <companyRanking>Inc 5000</companyRanking>
</companyDetailResponse>

Output Parameters – Company Detail

The table below shows output parameters that can be used in Company Detail queries. Parameter descriptions are grouped as follows:

  • Group - The grouping for output field permissions. The permission groups configured for a partner determine the output fields present in a response.
  • Parent Name - Name of the 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
CompanyID

Unique identifier used by ZoomInfo for companies
ZoomCompanyURL

The URL to the company profile on zoominfo.com public site
Company Logo

The URL which can be used to retrieve the logo for the company.
Hashtag
The list of hash tags for the displayed company. Each hash tag is composed of tag name and display label.
Company Name
CompanyName

Name of the company
CompanyTicker

The stock ticker for the company if available
Company Phone
Phone

Primary phone number for the company
Company Fax
Fax

Primary fax number for the company
Website
Website

The web domain for the company in http://www.example.com format
Primary Address
CompanyAddress

Contains the following child elements describing the company's primary address
Street
Street address for the company's primary address
City
City for the company's primary address
State
State for the company's primary address
Zip
Zip code of the company's primary address
CountryCode
Country code for the company's primary address
Other Addresses
OtherCompanyAddresses

Contains the following child elements describing a company's secondary address. A company who has branches or multiple offices will commonly have multiple OtherCompanyAddresses.
Street
Street address for the company's other address
City
City for the company's other address
State
State for the company's other address
Zip
Zip code for the company's other address
CountryCode
Country code for the company's other address
Revenue and Employees
Revenue

Approximate yearly revenue for the company
RevenueIn000s
Approximate numeric yearly revenue for the company in 1000's. Optional: This output field won't be shown unless the 'outputFieldOptions' parameter contains "companyRevenueNumeric"
RevenueRange
Approximate yearly revenue range for the company. Optional:This output field won't be shown unless the 'outputFieldOptions' parameter contains “companyRevenueRange”
Employees

Approximate number of people employed by the company
EmployeesRange

Approximate range for the number of people employed by the company. Optional:This output field won't be shown unless the 'outputFieldOptions' parameter contains “companyEmployeeRange”
Industries  
TopLevelIndustry The top level (and therefore least specific) industry grouping for the company. A company can have multiple top level industries. Optional:This output field won't be shown unless the 'outputFieldOptions' parameter contains “companyTopLevelIndustry”
companyType
The type of the returned company. The value is one of the followings:public, private, npo, education, or government. (npo stands for non-profit organization) Optional:This outputfield won't be shown unless the 'outputFieldOptions' parameter contains “companyType”
Industry

The industry grouping for the company. A company can have multiple industries.
companySIC
Four-digit numerical codes assigned by the U.S. government to business establishments to identify the primary business of the establishment

companyNACIS
Define establishments based on the activities in which they are primarily engaged.

companyProductsAndServices
Products and services of the company

Description
CompanyDescription

A short paragraph describing the main purpose of the company
M&A Info
MergerAcquisition

Contains the following child elements of a company that has been involved in a merger or acquisition with requested company
CompanyID
The ZoomInfo unique identifier for the company
ZoomCompanyURL
The URL to the company's zoominfo.com public site summary
CompanyDetailXmlUrl
API request URL for Company Detail. Returned output will be in XML format
CompanyName
The name of the company that was involved in M&A activity with the parent company
Ranked Lists
CompanyRanking

Ranked company list that the company has appeared in (ex. Fortune 500). A company can belong to more than one ranked list.
Key People
KeyPerson

Contains the following child elements of a person who is a key person at the requested company
PersonID
The ZoomInfo unique identifier for the person
ZoomPersonURL
The URL to the person's zoominfo.com public site summary
PersonDetailXmlUrl
API request URL for Person Detail. Returned output will be in XML format
FirstName
First name of the person
LastName
Last name of the person
JobTitle
Job title of the person at the requested company



Was this article helpful?

Can’t find what you’re looking for?

Contact our award-winning customer care team.