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/v2/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.)
	maxNumKeyPerson	optional		May only be used in conjunction with includeKeyPerson input.
	outputFieldOptions	optional		Company Detail Query has the following output field: companyDomains companyRevenueNumeric companyRevenueRange companyEmployeeRange companyTopLevelIndustry companyLogo companyProductsAndServices companysubsidiary companystructure continent funding isdefunct companyHashtags companyAttributeValues acquiredByCompany orderHashtags companyType techAttributes similarCompanies lowestSICSOnly lowestNAICSOnly numericFull familyTree (Caution: family trees may be very large and therefore adding these to your output may affect performance) To return this field, specify the above output field name. For example, "outputFieldOptions=companyRevenueNumeric" will return Revenuein000s in the XML 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 (Searches companies for this technology product) 2) ParentCategory.Category.Vendor.* (Searches for companies with products under specified ParentCategory, Category and Vendor) 3) ParentCategory.Category.* (Searches for companies with products under specified ParentCategory, Category) 4) .Vendor. (Searches for companies with products under specified Vendor) Examples: 6356 332.7.11831., 332.7.,6356 .11831., 6356
Company ID or Company Domain	CompanyID	cid or domain		The company's ZoomInfo ID
Company ID or Company Domain	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
Company Name	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

Company Detail

Input Parameters – Company Detail

Example Company Detail Query

Output Parameters – Company Detail

Quick Jump

Can’t find what you’re looking for?