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 HTTP request for Company Detail begins with the URL structure:

http://partnerapi.zoominfo.com/partnerapi/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
  • Key - Denotes whether or not the key generation uses the field. 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
key
required
 String consisting of 5 parameters concatenated together, and then encrypted with MD5. Parameters are:
 1) First two characters of CompanyID (query dependent) and first two characters of CompanyDomain (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
outputType
optional
xml or json
The format type of the response content. Case insensitive.
no
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.)
no
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
no
Company ID or Company Domain
CompanyID
cid or domain

The company's ZoomInfo ID
yes
CompanyDomain
cid or domain

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


Example Company Detail Query

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

  • www.ibm.com for CompanyDomain

Here is the structure of the Company Detail query:

http://partnerapi.zoominfo.com/partnerapi/company/detail?pc=PartnerCode&CompanyDomain=www.ibm.com&key=EncryptedKey

The Company Detail output appears in XML as follows:

<CompanyDetailRequest xmlns="http://partnerapi.zoominfo.com/partnerapistatic/xsd/V1/CompanyDetail.xsd">
 <CompanyID>18579882</CompanyID>
 <ZoomCompanyUrl> http://www.zoominfo.com/#!search/profile/company?companyId=18579882&targetid=profile </ZoomCompanyUrl>
 <CompanyName>IBM Corporation</CompanyName>
 <CompanyTicker>NYSE: IBM</CompanyTicker>
 <Phone>(914) 499-1900</Phone>
 <Fax>(914) 499-2188</Fax>
 <Website>www.ibm.com</Website>
 <CompanyAddress>
 <Street>1 New Orchard Road</Street>
 <City>Armonk</City>
 <State>New York</State>
 <Zip>10504</Zip>
 <CountryCode>United States</CountryCode>
 </CompanyAddress>
 <OtherCompanyAddress>
 <Street>3039 Cornwallis Road</Street>
 <City>Research Triangle Park</City>
 <State>North Carolina</State>
 <Zip>27709</Zip>
 <CountryCode>United States</CountryCode>
 </OtherCompanyAddress>
 <OtherCompanyAddress>
 <Street>650 Harry Road</Street>
 <City>San Jose</City>
 <State>California</State>
 <Zip>95120</Zip>
 <CountryCode>United States</CountryCode>
 </OtherCompanyAddress>
 <OtherCompanyAddress>
 <Street>1701 North Street</Street>
 <City>Endicott</City>
 <State>New York</State>
 <Zip>13760</Zip>
 <CountryCode>United States</CountryCode>
 </OtherCompanyAddress>
 <OtherCompanyAddress>
 <Street>55 Second Street</Street>
 <City>San Francisco</City>
 <State>California</State>
 <Zip>94105</Zip>
 <CountryCode>United States</CountryCode>
 </OtherCompanyAddress>
 <Employees>431212</Employees>
 <Revenue>$106.9 Billion</Revenue>
 <Industry>Software Development & Design</Industry>
 <Industry>Software</Industry>
 <Industry>Personal Computers & Peripherals</Industry>
 <Industry>Computer Equipment & Peripherals</Industry>
 <Industry>Manufacturing</Industry>
 <Industry>Consumer Electronics</Industry>
 <Industry>Consumer Goods</Industry>
 <Industry> Internet Service Providers, Website Hosting & Internet-related Services </Industry>
 <Industry>Telecommunications</Industry>
 <Industry>Storage & System Management Software</Industry>
 <Industry>Content & Collaboration Software</Industry>
 <Industry>Business Intelligence Software(BI)</Industry>
 <Industry>Security software</Industry>
 <Industry>Customer Relationship Management Software(CRM)</Industry>
 <Industry>Networking Software</Industry>
 <Industry>Supply chain management Software(SCM)</Industry>
 <CompanyDescription> International Business Machines Corporation (IBM), is an information technology (IT) company. s majoroperations include Global Technology Services segment (GTS), Global Business Services segment (GBS), Software segment, Systems and Technology segment, and Global Financing segment. On January 31, 2008, the Company acquired 100% of Cognos, Inc. On April 3, 2008, IBM acquired 100% of Telelogic, AB. In July2008, the Company acquired Platform Solutions, Inc. In December 2008, its internal global logistics operations were acquired by SNCF Transport and logistics division of Geodis. In July 2009, IBM acquired Ounce Labs, Inc., a privately held company based in Waltham, Massachusetts, whose software helps companies to reduce the risks and costs associated with security and compliance concerns. In August 2009, the Company announced the launch of its China Analytics Solution Center, part of a network of global centers. </CompanyDescription>
 <MergerAcquisition>
 <CompanyID>81249685</CompanyID>
 <ZoomCompanyUrl> http://www.zoominfo.com/#!search/profile/company?companyId=81249685&targetid=profile </ZoomCompanyUrl>
 <CompanyDetailXmlUrl> http://partnerapi.zoominfo.com/partnerapi/company/detail?query_type=company_detail&CompanyID=81249685&pc=PartnerCode&key=EncryptedKey </CompanyDetailXmlUrl>
 <CompanyName>Initiate Systems , Inc.</CompanyName>
 </MergerAcquisition>
 <MergerAcquisition>
 <CompanyID>4669634</CompanyID>
 <ZoomCompanyUrl> http://www.zoominfo.com/#!search/profile/company?companyId=4669634&targetid=profile </ZoomCompanyUrl>
 <CompanyDetailXmlUrl> http://partnerapi.zoominfo.com/partnerapi/company/detail?query_type=company_detail&CompanyID=4669634&pc=PartnerCode&key=EncryptedKey </CompanyDetailXmlUrl>
 <CompanyName>BigFix , Inc.</CompanyName>
 </MergerAcquisition>
 <MergerAcquisition>
 <CompanyID>37634600</CompanyID>
 <ZoomCompanyUrl> http://www.zoominfo.com/#!search/profile/company?companyId=37634600&targetid=profile </ZoomCompanyUrl>
 <CompanyDetailXmlUrl> http://partnerapi.zoominfo.com/partnerapi/company/detail?query_type=company_detail&CompanyID=37634600&pc=PartnerCode&key=EncryptedKey </CompanyDetailXmlUrl>
 <CompanyName>TeaLeaf Technology Inc</CompanyName>
 </MergerAcquisition>
 <MergerAcquisition>
 <CompanyID>344939828</CompanyID>
 <ZoomCompanyUrl> http://www.zoominfo.com/#!search/profile/company?companyId=344939828&targetid=profile </ZoomCompanyUrl>
 <CompanyDetailXmlUrl> http://partnerapi.zoominfo.com/partnerapi/company/detail?query_type=company_detail&CompanyID=344939828&pc=PartnerCode&key=9cdccd180df04d66ae3f3416af89a45f </CompanyDetailXmlUrl>
 <CompanyName>i2 Inc.</CompanyName>
 </MergerAcquisition>
 ...
 <CompanyRanking>Fortune 100</CompanyRanking>
 <CompanyRanking>Global 500</CompanyRanking>
 <CompanyRanking>Russell 3000</CompanyRanking>
</CompanyDetailRequest>

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.