Hoover's API Version 3.2 - Company
Queries - Company Information
IMPORTANT: All calls on this page require an API key
New features are highlighted.
1 Find Company By Keyword Search
1.1 Overview
Returns a set of companies based on keyword, along with basic identifying data for each company.
1.2 Input Parameters
Required fields are indicated with.
Field Name | Value | Notes |
keyword | String containing a keyword or phrase | |
maxRecords | Between 1-200. Default = 20 | |
hitOffset | Greater than or equal to 0 but less than or equal to 10,000. Default = 0 | Paging support, the firstHit returned will be hitOffset + 1. hitOffset is now zero-based. |
searchBy | One of the included enumeration called SearchByFields | Can appear multiple times in the Request. Allows the user to search against just Company Name or Stock Symbol (or both) instead of the more generic search across many company fields if not included. |
orderBy | Values defined in WSDL, orderByTypes | Relevant values for this search include:
|
sortDirection | Values defined in WSDL: sortDirectionTypes - Ascending or Descending | This has no effect without a valid orderBy. |
returnSearchNavigation | 'true' or 'false' | If true navigators will be returned in the response to enable drill down into search results |
searchNavigation/ employeeSearchNavigation/ employeeSearchNavigationValue | An employee navigation link which can be fed back into other calls. | The employee navigation link must be used to drill down by number of employees. |
searchNavigation/ locationTypeSearchNavigation/ locationTypeSearchNavigationValue | A location type navigation link which can be fed back into other calls. | The location type navigation link must be used to drill down by location type. |
searchNavigation/ companyTypeSearchNavigation/ companyTypeSearchNavigationValue | A company type navigation link which can be fed back into other calls. | The company type navigation link must be used to drill down by company type. |
searchNavigation/ salesSearchNavigation/ salesSearchNavigationValue | A sales navigation link which can be fed back into other calls. | The sales navigation link must be used to drill down by sales. |
searchNavigation/ locationSearchNavigation/ countryNavigation/ countryNavigationValue | A country navigation link which can be fed back into other calls. | The country navigation link must be used to drill down by country. |
searchNavigation/ locationSearchNavigation/ countryNavigation/ stateNavigation/ stateNavigationValue | A state/province navigation link which can be fed back into other calls. | The state/province navigation link must be used to drill down by state/province. |
searchNavigation/ locationSearchNavigation/ countryNavigation/ stateNavigation/ cityNavigation/ cityNavigationValue | A city navigation link which can be fed back into other calls. | The city navigation link must be used to drill down by city. |
searchNavigation/ industrySearchNavigation/ industrySearchNavigationValue | A industry navigation link which can be fed back into other calls. | The industry navigation link must be used to drill down by industry. |
searchNavigation/ industrySearchNavigation/ ussicSearchNavigationValue | A UsSIC navigation link which can be fed back into other calls. | The UsSIC navigation link must be used to drill down by UsSIC. |
searchNavigation/ industrySearchNavigation/ naicsSearchNavigationValue | A NaICS navigation link which can be fed back into other calls. | The NaICS navigation link must be used to drill down by NaICS. |
1.3 Output Parameters
Field Name | Value | Notes |
\return\navigators | Contains lists of navigation links | The values in the navigation link lists must be fed back into other calls with the same keyword |
\return\navigators\employeeNavigators\employeeNavigator\employeeNavigatorValue | The value of a navigation link for number of employees | To drill down on number of employees a value from this element must be fed back into another call with the same keyword. |
\return\navigators\employeeNavigators\employeeNavigator\employeeNavigatorDescription | The description of a navigation link for number of employees | Could be used as a display value for the link |
\return\navigators\locationTypeNavigators\locationTypeNavigator\locationTypeNavigatorValue | The value of a navigation link for location type | To drill down on location type a value from this element must be fed back into another call with the same keyword. |
\return\navigators\locationTypeNavigators\locationTypeNavigator\locationTypeNavigatorDescription | The description of a navigation link for location type | Could be used as a display value for the link |
\return\navigators\companyTypeNavigators\companyTypeNavigator\companyTypeNavigatorValue | The value of a navigation link for company type | To drill down on company type a value from this element must be fed back into another call with the same keyword. |
\return\navigators\companyTypeNavigators\companyTypeNavigator\companyTypeNavigatorDescription | The description of a navigation link for company type | Could be used as a display value for the link |
\return\navigators\salesNavigators\salesNavigator\salesNavigatorValue | The value of a navigation link for final sales | To drill down on sales a value from this element must be fed back into another call with the same keyword. |
\return\navigators\salesNavigators\salesNavigator\salesNavigatorDescription | The description of a navigation link for sales | Could be used as a display value for the link |
\return\navigators\locationNavigators\countryNavigators\countryNavigator\countryNavigatorValue | The value of a navigation link for country | To drill down on country a value from this element must be fed back into another call with the same keyword. |
\return\navigators\locationNavigators\countryNavigators\countryNavigator\countryNavigatorDescription | The description of a navigation link for country description | Could be used as a display value for the link |
\return\navigators\locationNavigators\countryNavigators\countryNavigator\stateProvinceNavigators\stateProvinceNavigator\stateProvinceNavigatorValue | The value of a navigation link for state/province | To drill down on state/province a value from this element must be fed back into another call with the same keyword. |
\return\navigators\locationNavigators\countryNavigators\countryNavigator\stateProvinceNavigators\stateProvinceNavigator\stateProvinceNavigatorDescription | The description of a navigation link for state/province description | Could be used as a display value for the link |
\return\navigators\locationNavigators\countryNavigators\countryNavigator\stateProvinceNavigators\stateProvinceNavigator\cityNavigators\cityNavigator\cityNavigatorValue | The value of a navigation link for city | To drill down on city a value from this element must be fed back into another call with the same keyword. |
\return\navigators\locationNavigators\countryNavigators\countryNavigator\stateProvinceNavigators\stateProvinceNavigator\cityNavigators\cityNavigator\cityNavigatorDescription | The description of a navigation link for city description | Could be used as a display value for the link |
\return\navigators\industryNavigators\industryNavigator\industryNavigatorValue | The value of a navigation link for industry | To drill down on industry a value from this element must be fed back into another call with the same keyword. |
\return\navigators\industryNavigators\industryNavigator\industryNavigatorDescription | The description of a navigation link for industry | Could be used as a display value for the link |
\return\navigators\industryNavigators\ussicNavigator\ussicNavigatorValue | The value of a navigation link for UsSIC | To drill down on UsSIC a value from this element must be fed back into another call with the same keyword. |
\return\navigators\industryNavigators\ussicNavigator\ussicNavigatorDescription | The description of a navigation link for UsSIC | Could be used as a display value for the link |
\return\navigators\industryNavigators\naicsNavigator\naicsNavigatorValue | The value of a navigation link for NaICS | To drill down on NaICS a value from this element must be fed back into another call with the same keyword. |
\return\navigators\industryNavigators\naicsNavigator\naicsNavigatorDescription | The description of a navigation link for NaICS | Could be used as a display value for the link |
\return\resultSet\firstHit | First Hit | |
\return\resultSet\hits | Total Number of Hits in this Response | |
\return\resultSet\lastHit | Last Hit | |
\return\resultSet\totalHits | Aggregate Total Number of Hits | This is the total number of results the search returned |
\return\resultSet\hit\hitNumber | Hit Number | |
\return\resultSet\hit\companyResults | Company Results | |
\return\resultSet\hit\companyResults\companyId | Hoover's Company ID | |
\return\resultSet\hit\companyResults\duns | DUNS Number | |
\return\resultSet\hit\companyResults\companyName | Company Name | |
\return\resultSet\hit\companyResults\locationType | Location type such as Headquarters or branch | |
\return\resultSet\hi\companyResults\address1 | Street Address | |
\return\resultSet\hit\companyResults\city | Address City | |
\return\resultSet\hit\companyResults\country | Address Country | |
\return\resultSet\hit\companyResults\countryId | Address Country ID | |
\return\resultSet\hit\companyResults\stateOrProvince | Address State/Province | ID Value from GetAdvancedSearchLookups |
\return\resultSet\hit\companyResults\primaryUrl | Primary URL | |
\return\resultSet\hit\companyResults\parentDuns | Parent Company DUNS Number | |
\return\resultSet\hit\companyResults\ultimateParentDuns | Ultimate Parent Company DUNS Number | |
\return\resultSet\hit\companyResults\sales | Annual Sales | |
\return\companies\hit\companyResults\hqPhone | Headquarters Phone Number | |
\return\companies\hit\companyResults\dbas | List of DBA names | |
\return\companies\hit\companyResults\dbas\dba | Doing Business As Company Name | |
\return\companies\hit\companyResults\historicalIndicator | Indicates that the company has ceased operations | Value of 'true' indicates that the company has ceased operations |
2 Advanced Company Search
2.1 Overview
Returns search result of companies based on various different criteria
2.2 Input Parameters
Field Name | Value | Notes |
\bal\maxrecords | Max Records | Between 1-200. Default = 20 |
\bal\hitOffset | Greater than or equal to 0 but less than or equal to 10,000. Default = 0 | Paging support, the firstHit returned will be hitOffset + 1. hitOffset is now zero-based. |
\bal\sortdirection | Sort Direction | Values defined in WSDL: sortDirectionTypes - Ascending or Descending |
\bal\orderby | Order By | Values defined in WSDL, orderByTypes |
\bal\companySize\employeesFrom | Total Employees Lower Bound | |
\bal\companySize\employeesTo | Total Employees Upper Bound | |
\bal\companySize\employeesGrowthFrom | Total Employees Growth Percentage Lower Bound | |
\bal\companySize\employeesGrowthTo | Total Employees Growth Percentage Upper Bound | |
\bal\companySize\employeesThisLocationFrom | Employees at this Location Lower Bound | |
\bal\companySize\employeesThisLocationTo | Employees at this Location Upper Bound | |
\bal\companySize\marketCapFrom | Market Cap ($ mil) Lower Bound | |
\bal\companySize\marketCapTo | Market Cap ($ mil) Upper Bound | |
\bal\companySize\salesFrom | Annual Sales ($ mil) Lower Bound | |
\bal\companySize\salesTo | Annual Sales ($ mil) Upper Bound | |
\bal\companySize\salesGrowthFrom | Annual Sales Growth (%) Lower Bound | |
\bal\companySize\salesGrowthTo | Annual Sales Growth (%) Upper Bound | |
\bal\companyType\location | Location Type | ID Value from GetAdvancedSearchLookups |
\bal\companyType\ownershipType | Values are 1 (Public), 21 (Owned by a Public Company) or 0 (Non-Public). | |
\bal\companyType\subsidiaryStatus | Subsidiary Status | Subsidiary or Not a Subsidiary |
\bal\financialdata\advertisingExpenseFrom | Ad Expense ($ mil) Lower Bound. | |
\bal\financialdata\advertisingExpenseTo | Ad Expense ($ mil) Upper Bound. | |
\bal\financialdata\assetsFrom | Assets ($ mil) Lower Bound. | |
\bal\financialdata\assetsTo | Assets ($ mil) Upper Bound. | |
\bal\financialdata\filingDateFrom | Filing Date Lower Bound | MM/DD/YYYY |
\bal\financialdata\filingDateTo | Filing Date Upper Bound | MM/DD/YYYY |
\bal\financialdata\fiscalYearEnd | Fiscal Year End Month | |
\bal\financialdata\incomeFrom | Net Income ($ mil) Lower Bound. | |
\bal\financialdata\incomeGrowthFrom | Net Income Growth (%) Lower Bound | |
\bal\financialdata\incomeGrowthTo | Net Income Growth (%) Upper Bound | |
\bal\financialdata\incomeTo | Net Income ($ mil) Upper Bound | |
\bal\financialdata\offerFrom | US IPO Data - Offer Amount ($ mil.) Lower Bound | |
\bal\financialdata\offerTo | US IPO Data - Offer Amount ($ mil.) Upper Bound | |
\bal\financialdata\priceRangeFrom | US IPO Data - Price Range ($) Lower Bound | |
\bal\financialdata\priceRangeTo | US IPO Data - Price Range ($) Upper Bound | |
\bal\financialdata\researchExpenseFrom | R&D Expense ($ mil) Lower Bound | |
\bal\financialdata\researchExpenseTo | R&D Expense ($ mil) Upper Bound | |
\bal\financialdata\tradingDateFrom | Trading Date Lower Bound | MM/DD/YYYY |
\bal\financialdata\tradingDateTo | Trading Date Upper Bound | MM/DD/YYYY |
\bal\financialdata\underwriterId | Underwriters | ID Value from GetAdvancedSearchLookups. It searches only the lead underwriter for the given underwriterId. |
\bal\financialdata\marketingPreScreenScore | Marketing pre-screen scores | Enumerated values of either 'L' Low, 'M' Medium or 'H' High accepted. Allows for unique combinations of the preceding values from 0 to 3 times. |
\bal\industry\hooversIndustryCode | Hoover's Industry Name | ID Value from GetAdvancedSearchLookups |
\bal\industry\primaryOnly | Primary Industry Only | Boolean |
\bal\industry\nAICS | NAICS Code | Enter only one code per element. Use multiple elements for multiple codes. Enter at least two digits per code. No CSV or Ranges can be specified |
\bal\industry\nAICSRange\[from|to] | NAICS Code Ranges | Enter one or more range elements. Each range element must contain 'from' and a 'to' element. |
\bal\industry\uSSIC | US SIC Code | Enter only one code per element. Use multiple elements for multiple codes. Enter at least two digits per code. No CSV or Ranges can be specified |
\bal\industry\uSSICRange\[from|to] | SIC Code Ranges | Enter one or more range elements. Each range element must contain 'from' and a 'to' element. |
\bal\industry\uKSIC | UK SIC Code | Enter only one code per element. Use multiple elements for multiple codes. Enter at least two digits per code. No CSV or Ranges can be specified |
\bal\industry\uKSICRange\[from|to] | UKSIC Code Ranges | Enter one or more range elements. Each range element must contain 'from' and a 'to' element. |
\bal\location\areacode | US/Canada Area Code | e.g. 512 or 210. To search with multiple area codes, create multiple area code elements one beneath another |
\bal\location\streetAddress | Street Address | e.g. 1700 Pennsylvania Ave. |
\bal\location\county | Wrapper for county type | Searching by multiple counties is allowed, send in multiple county wrapper elements |
\bal\location\county\countyId | County ID | ID Value from GetAdvancedSearchLookups |
\bal\location\county\state | State | ID Value from GetAdvancedSearchLookups |
\bal\location\county\countryId | Country ID | ID Value from GetAdvancedSearchLookups |
\bal\location\city | City | e.g. Madrid or New York (single city only) |
\bal\location\countryId | Country | ID Value from GetAdvancedSearchLookups |
\bal\location\globalState | Global State/Province | e.g Queensland or NY (single province/state only) |
\bal\location\metropolitanId | US Metropolitan Area | ID Value from GetAdvancedSearchLookups |
\bal\location\regionId | World Region | ID Value from GetAdvancedSearchLookups |
\bal\location\usStateCanadaProvince | US State/Canada Province | |
\bal\location\postalCode | Postal Code | e.g. 78701 or "SW1P 1JA" or "SW1". To search with multiple codes, create multiple Postal code elements one beneath another |
\bal\location\usZipCodeRange\from | US ZIP Code Lower Bound | |
\bal\location\usZipCodeRange\to | US ZIP Code Upper Bound | |
\bal\location\zipAreaSearch\scale | Units to search in: miles or kilometers | e.g. Find results within 50 miles of 78745 (up to a maximum radius of 100 miles or 160 km). Use only one 5-digit ZIP code. Requires zipareawithin and zipareazipcode. |
\bal\location\zipAreaSearch\radius | # of miles or kilometers to search within. | e.g. Find results within 50 miles of 78745 (up to a maximum radius of 100 miles or 160 km). Use only one 5-digit ZIP code. Requires zipareawithin and zipareazipcode. |
\bal\location\zipAreaSearch\zipCode | Zipcode to search within (78745 in the example) | e.g. Find results within 50 miles of 78745 (up to a maximum radius of 100 miles or 160 km). Use only one 5-digit ZIP code. Requires zipareawithin and zipareazipcode. |
\bal\location\latLongSearch\scale | Units to search in: miles or kilometers | Requires radius, latitude, and longitude. |
\bal\location\latLongSearch\radius | # of miles or kilometers to search within. | Requires scale, latitude, and longitude. |
\bal\location\latLongSearch\latitude | latitude | Requires scale, radius, and longitude. |
\bal\location\latLongSearch\longitude | longitude | Requires scale, radius, and latitude. |
\bal\location\allAny | All or Any Matches on Location Criteria | Matching ALL means a company would have to match each type of criteria entered. Matching ANY means that a company could match any single type of criteria entered. Valid values All or Any |
\bal\location\ukCounty | UK County | A valid UK County name |
\bal\specialtyCriteria\auditorId | Auditors | ID Value from GetAdvancedSearchLookups |
\bal\specialtyCriteria\companyKeyword | Company Keyword | e.g. laptops or China or acquired, merged, takeover |
\bal\specialtyCriteria\duns | DUNS Number | |
\bal\specialtyCriteria\exchangeId | Exchange | ID Value from GetAdvancedSearchLookups |
\bal\specialtyCriteria\rankingId | Rankings/Indices | ID Value from GetAdvancedSearchLookups |
\bal\specialtyCriteria\ukRegistration | UK Registration Number | e.g. 3443456 or 3443456, 0764797 |
\bal\specialtyCriteria\ukVat | UK Vat Number | e.g. 906565610 or 906565610, 466264724 |
\bal\specialtyCriteria\yearFoundingFrom | Year of Founding or Change in Control Lower Bound | YYYY |
\bal\specialtyCriteria\yearFoundingTo | Year of Founding or Change in Control (YYYY) Upper Bound | YYYY |
\bal\specialtyCriteria\ultimateParentDuns | The ultimate parent DUNS number for a family of companies | eg. 060902413 or 884364530 |
\bal\specialtyCriteria\primaryUrl | Primary URL | |
\bal\specialtyCriteria\companyName | Company Name |
2.3 Output Parameters
Field Name | Value | Notes |
\return\companies\firstHit | First Hit | |
\return\companies\hits | Total Number of Hits in this Response | |
\return\companies\lastHit | Last Hit | |
\return\companies\totalHits | Aggregate Total Number of Hits | This is the total number of results the search returned |
\return\companies\hit\hitNumber | Hit Number | |
\return\companies\hit\companyResults | Company Results | |
\return\companies\hit\companyResults\companyId | Hoover's Company ID | |
\return\companies\hit\companyResults\duns | DUNS Number | |
\return\companies\hit\companyResults\companyName | Company Name | |
\return\companies\hit\companyResults\locationType | Location type such as Headquarters or branch | |
\return\resultSet\hit\companyResults\address1 | Street Address | |
\return\companies\hit\companyResults\city | Address City | |
\return\companies\hit\companyResults\country | Address Country | |
\return\companies\hit\companyResults\countryId | Address Country ID | |
\return\companies\hit\companyResults\stateOrProvince | Address State/Province | ID Value from GetAdvancedSearchLookups |
\return\companies\hit\companyResults\primaryUrl | Primary URL | |
\return\companies\hit\companyResults\parentDuns | Parent Company DUNS Number | |
\return\companies\hit\companyResults\ultimateParentDunsNumber | Ultimate Parent Company DUNS Number | |
\return\companies\hit\companyResults\sales | Annual Sales | |
\return\companies\hit\companyResults\hqPhone | Headquarters Phone Number | |
\return\companies\hit\companyResults\dbas | List of DBA names | |
\return\companies\hit\companyResults\dbas\dba | Doing Business As Company Name | |
\return\companies\hit\companyResults\historicalIndicator | Indicates that the company has ceased operations | Value of 'true' indicates that the company has ceased operations |
3 Get Company Detail
3.1 Overview
Returns detailed company information for a single company based on criteria of a DUNS or a Hoover's Company ID. Either DUNS or Hoover's Company ID are allowed.
3.2 Input Parameters
Required fields are indicated with.
Field Name | Value | Notes |
uniqueId | Hoover's Company ID -OR- DUNS Number | See note above |
3.3 Output Parameters
Field Name | Value | Notes |
\return\companyId | Hoover's Company ID | |
\return\duns | DUNS number of this company. | |
\return\companyType | Company Type such as Public, Private, etc | |
\return\locationType | Company Location Type such as Head Quarters, Single Location, etc | |
\return\ultimateParentDuns | The Ultimate Parent DUNS number | |
\return\ultimateParentName | The Ultimate Parent name corresponding to the ultimate parent DUNS number | |
\return\parentDuns | Hoover's ID of the company's immediate parent | |
\return\parentName | Company name of this company's immediate parent. | |
\return\name | Company Name | |
\return\dbaNames | Contains all Doing Business As names | |
\return\dbaNames\dba | Doing Business As | |
\return\industries\primaryHIC | HIC Code | Replaces hicName (HIC Name) |
\return\industries\primaryNAICS | NAICS Code | |
\return\industries\primaryUSSIC | US SIC Code | |
\return\industries\primaryUKSIC | Primary UK SIC Code | |
\return\industries\allUKSIC | Collection of all UK SIC Codes | |
\return\industries\allUKSIC\item\code | UK SIC Code | |
\return\industries\allUKSIC\item\description | Description of industry referred to | |
\return\industries\allUSSIC | Collection of all US SIC Codes | |
\return\industries\allUSSIC\item\ussic | US SIC Code | |
\return\industries\allUSSIC\item\description | Description of the industry represented by the USSIC | |
\return\industries\allHIC | Collection of all Hoover's Industry Codes | |
\return\industries\allHIC\item\hic | Hoover's Industry Code | |
\return\industries\allHIC\item\description | Description of the industry represented by the HIC | |
\return\industries\allNAICS | Collection NAICS codes for the company | |
\return\industries\allNAICS\item\naics | NAICS code | |
\return\industries\allNAICS\item\description | Description of the industry represented by the NAICS | |
\return\subsidiaryStatus | Subsidiary Status | |
\return\keyNumbersHistory\annualKeyNumbersHistory | Annual Financial Figures | |
\return\keyNumbersHistory\quarterlyKeyNumbersHistory | Quarterly Financial Figures | |
\return\keyNumbersHistory\<annualKeyNumbersHistory OR quarterlyKeyNumbersHistory>\keyNumbers | Financial Figures | Previous version of API did not specify maxOccurs=unbounded, so generated client code was only able to get a single element. The API has changed to return an array or other collection. |
\return\keyNumbersHistory\<annualKeyNumbersHistory OR quarterlyKeyNumbersHistory>\keyNumbers\sales | Annual Sales | This value is in US Dollars. |
\return\keyNumbersHistory\<annualKeyNumbersHistory OR quarterlyKeyNumbersHistory>\keyNumbers\employeesAtThisLocation | Employees at this Location | |
\return\keyNumbersHistory\<annualKeyNumbersHistory OR quarterlyKeyNumbersHistory>\keyNumbers\totalEmployeeGrowthPercent | Total Employee Growth % for the Year | |
\return\keyNumbersHistory\<annualKeyNumbersHistory OR quarterlyKeyNumbersHistory>\keyNumbers\researchAndDevelopment | R&D Expenses for the Year | This value is in US Dollars. |
\return\keyNumbersHistory\<annualKeyNumbersHistory OR quarterlyKeyNumbersHistory>\keyNumbers\advertising | Advertising Expenses for the Year | This value is in US Dollars. |
\return\keyNumbersHistory\<annualKeyNumbersHistory OR quarterlyKeyNumbersHistory>\keyNumbers\employeesTotal | Total Employees | |
\return\keyNumbersHistory\<annualKeyNumbersHistory OR quarterlyKeyNumbersHistory>\keyNumbers\record-type | Sales Record Type | Q = quarter, A = annual |
\return\keyNumbersHistory\<annualKeyNumbersHistory OR quarterlyKeyNumbersHistory>\keyNumbers\fiscal-period | Fiscal Period | |
\return\keyNumbersHistory\<annualKeyNumbersHistory OR quarterlyKeyNumbersHistory>\keyNumbers\periodEndMonth | Period End Month | |
\return\locations | Company Addresses | Previous version of API did not specify maxOccurs=unbounded, so generated client code was only able to get a single element. The API has changed to return an array or other collection. |
\return\locations\address1 | Company Address | |
\return\locations\address2 | Company Address Line 2 | |
\return\locations\city | Company City | |
\return\locations\state | Company State | |
\return\locations\country | Company Country Name | Previous version of the API displayed Country Id in this element. API is changed to display CountryName. |
\return\locations\countryId | Company Country ID | |
\return\locations\zip | Company Zip Code | |
\return\locations\zip4 | Company Zip Plus 4 | |
\return\locations\latitude | Latitude | |
\return\locations\longitude | Longitude | |
\return\locations\latLongAccuracy | Accuracy of latitude and longitude | |
\return\locations\addressType | Address Type such as Primary, Headquarters, Mailing etc. | |
\return\locations\metroArea | The metropolitan area for the location | |
\return\ownershipYear | Ownership Year | |
\return\phone | Company Phone Numbers | |
\return\phones\[phoneNumber | faxNumber]\areaCode | Phone Number Area Code | |
\return\phones\[phoneNumber | faxNumber]\countryCode | Address Country ID | |
\return\phones\[phoneNumber | faxNumber]\phoneNumber | Phone Number | |
\return\synopsis | Company Description | |
\return\full-description | Full Company Description | |
\return\stocks\tickerUS | Ticker Symbol used for this company. | |
\return\stocks\exchangeInfoList | Collection of exchange information. | |
\return\stocks\exchangeInfoList\exchangeInfo\country | Country name where exchange is located. | |
\return\stocks\exchangeInfoList\exchangeInfo\tickerSymbol | Ticker Symbol used for this company in this exchange. | |
\return\stocks\exchangeInfoList\exchangeInfo\exchangeName | Exchange name where this company is traded. | |
\return\top-executives | Top 3 Company Executives | |
\return\top-executives\official | Company Executive | |
\return\top-executives\official\coOfficialId | Hoover's Official ID | |
\return\top-executives\official\latest-position | Most recent position information | |
\return\top-executives\official\latest-position\title | Person Title | |
\return\top-executives\official\latest-position\start-year | Latest position start year | |
\return\top-executives\official\latest-position\end-year | Latest position end year | |
\return\top-executives\official\latest-salary | Most recent salary information | |
\return\top-executives\official\latest-salary\year | Latest salary year | |
\return\top-executives\official\latest-salary\salary | Salary for the year, excluding bonus in USD | |
\return\top-executives\official\latest-salary\total-salary | Total compensation for the year, including any bonus or other compensation in USD | |
\return\top-executives\official\latest-salary\bonus | Bonus for the year, in USD | |
\return\top-executives\official\person\full-name | Person Full Name | |
\return\top-executives\official\person\last-name | Person Last Name | |
\return\top-executives\official\person\first-name | Person First Name | |
\return\top-executives\official\person\middle-name | Person Middle Name | |
\return\top-executives\official\person\suffix | Person Suffix | |
\return\top-executives\official\person\prefix | Person Prefix | |
\return\top-executives\official\person\age | Person Age | |
\return\top-executives\official\connectMail | Wrapper element for ConnectMail indicators | |
\return\top-executives\official\connectMail\connectMailNameSource | Indicates if official's name is a ConnectMail contact | |
\return\top-executives\official\connectMail\connectMailEmailSource | Indicates if official's email is a ConnectMail contact | |
\return\top-executives\official\connectMail\connectMailPhoneSource | Indicates if official's phone number is a ConnectMail contact | |
\return\familyTreeLink | Corporate Family Tree Link | |
\return\primaryURLs | Company Primary URLs in sorted in ascending order | |
\return\primaryURLs\primaryURL\url | A primary url for a company | |
\return\primaryURLs\primaryURL\sortOrder | A number indicating the relative order of the accompanying url among all primary urls | |
\return\URLs | Company Urls | |
\return\accountingFirm | The accounting firm/auditor for this company. | |
\return\bankName | The bank name for this company. | |
\return\marketingPreScreenScore | The D&B Marketing Prescreen value for this company. | |
\return\keyFinancials | Contains market value and income asset information. | |
\return\keyFinancials\marketValueInfo | Contains market value information | |
\return\keyFinancials\marketValueInfo\marketValue | Market value (in millions of USD) of this company. | |
\return\keyFinancials\marketValueInfo\marketValueDate | Date of market valuation. | |
\return\keyFinancials\incomeAssets | Contains income asset information. | |
\return\keyFinancials\incomeAssets\period | Fiscal Period reporting date. | |
\return\keyFinancials\incomeAssets\assets | Total assets (in millions of USD) of this company. | |
\return\keyFinancials\incomeAssets\salesGrowthPercent | Sales growth in percent for this company. | |
\return\keyFinancials\incomeAssets\netIncome | Net income (in millions of USD) of this company. | |
\return\keyFinancials\incomeAssets\netIncomeGrowthPercent | Net income growth in percent of this company. | |
\return\ukSpecs | UK-specific information. | |
\return\ukSpecs\uKRegistration | UK Registration Number | e.g. 3443456 or 3443456, 0764797 |
\return\ukSpecs\uKVAT | UK Vat Number | e.g. 906565610 or 906565610, 466264724 |
\return\ukSpecs\numberOfSubsidiaries | Number of subsidiaries | |
\return\ukSpecs\numberOfSubsidiaries\domestic | Number of subsidiaries in the UK | |
\return\numberOfPCs | Number of PCs at the company | |
\return\spaceAtAddress | Space in square feet at the location | |
\return\spaceAtAddressUnitOfMeasurement | Unit of measurement for spaceAtAddress | |
\return\spaceAtAddressAccuracy | Accuracy of spaceAtAddress field | |
\return\ownedOrLeased | Indicates if the company's location is owned/leased | |
\return\manufacturingIndicator | Indicates if the company is a manufacturer | |
\return\legalStatus | Legal Status description for the company | |
\return\yearFounded | Year the company was founded | |
\return\minorityOwned | Indicates if the company is owned by a minority | |
\return\ethnicity | Ethnicity of business owner. | |
\return\womenOwned | Indicates if the company is owned by women | |
\return\rankings | A list of rankings that the company appears in, such as Fortune 500 | |
\return\rankings\rank\rankNumber | A company's rank on a ranking list, such as 100 on the Fortune 500 | |
\return\rankings\rank\definition | The name of the ranking list, such as 'Fortune 500' |
4 Get Company Detail Simple
4.1 Overview
Returns a reduced subset of company details for a given Hoover's Company ID or DUNS
4.2 Input Parameters
Required fields are indicated with.
Field Name | Value | Notes |
uniqueId | Hoover's Company ID -OR- DUNS Number |
4.3 Output Parameters
Field Name | Value | Notes |
\return\name | Company Name | |
\return\companyId | Hoover's Company ID | |
\return\primaryLocation\address1 | Company Address1 | |
\return\primaryLocation\address2 | Company Address2 | |
\return\primaryLocation\city | Company City | |
\return\primaryLocation\country | Company Country | |
\return\primaryLocation\state | Company State | |
\return\primaryLocation\zip | Postal code | |
\return\primaryLocation\zip4 | Postal code | |
\return\primaryPhone\countryCode | Address Country ID | |
\return\primaryPhone\areaCode | Phone Number Area Code | |
\return\primaryPhone\phoneNumber | Phone Number | |
\return\primaryURL | Primary URL for the company | |
\return\legalStatus | Legal Status description for the company | |
\return\yearFounded | Year the company was founded | |
\return\minorityOwned | Indicates if the company is owned by a minority | |
\return\womenOwned | Indicates if the company is owned by women |
5 Get Family Tree
5.1 Overview
Returns ultimate parent of the given DUNS or Hoover's Company ID and all of the children/descendants of that ultimate parent. Access to the GetFamilyTree service operation has been restricted. Please contact your sales representative for access.
5.2 Input Parameters
Required fields are indicated with.
Field Name | Value | Notes |
uniqueId | Hoover's Company ID -OR- DUNS Number | |
filters | Optional element used to filter the family tree results. | |
filters/city | City | Use multiple elements for multiple city values. |
filters/state | State | Use multiple elements for multiple state values. |
filters/country | Country | Use multiple elements for multiple country values. |
filters/locationType | Location Type | Use multiple elements for multiple location type values. |
filters/depthLimit | The number of layers or levels of the family tree structure to return. | An error will be returned if the value is less than 1. |
5.3 Output Parameters
Field Name | Value | Notes |
\return\name | Company Name | |
\return\companyId | Hoover's Company ID | |
\return\duns | DUNS Number | |
\return\parentDuns | Parent Company DUNS Number | |
\return\ultimateParentDuns | Ultimate Parent Company DUNS Number | |
\return\revenue | Revenue in millions of USD | |
\return\locationType | Location Type | Headquarters, Branch, etc. |
\return\city | Company City | |
\return\state | Company State | |
\return\country | Country | |
\return\totalChildren | Aggregate Total Number of Children for this unique ID | |
\return\children | This company's children | Previous version of API did not specify maxOccurs=unbounded, so generated client code was only able to get a single element. The API has changed to return an array or other collection. |
\return\children\child\number | Hit Number of the specific child | |
\return\children\child\name | Child Company Name | |
\return\children\child\companyId | Child Hoover's Company ID | |
\return\children\child\duns | Child DUNS Number | |
\return\children\child\parentDuns | Child Parent Company DUNS Number | |
\return\children\child\ultimateParentDuns | Child Ultimate Parent Company DUNS Number | |
\return\children\child\revenue | Child Revenue in millions of USD | |
\return\children\child\locationType | Child Location Type | Headquarters, Branch, etc. |
\return\children\child\city | Child Company City | |
\return\children\child\state | Child Company State | |
\return\children\child\country | Child Company Country | |
\return\children\child\children | This company's children | Previous version of API did not specify maxOccurs=unbounded, so generated client code was only able to get a single element. The API has changed to return an array or other collection. |
6 Find Competitors By Company ID
6.1 Overview
Returns all competitors for a given Hoover's Company ID or DUNS
6.2 Input Parameters
Required fields are indicated with.
Field Name | Value | Notes |
uniqueId | Hoover's Company ID -OR- DUNS Number | |
topCompetitor | true or false | set to true if only top competitors are to be returned |
6.3 Output Parameters
Field Name | Value | Notes |
\return\competitor\companyName | Competitor Company Name | |
\return\competitor\topcompetitor | Top Competitor? | true if the competitor is a top competitor to the given uniqueId |
\return\competitor\addrcity | Competitor City | |
\return\competitor\addrstateprov | Competitor State/Province | |
\return\competitor\addrcountry | Competitor Country | |
\return\competitor\addrcountryid | Competitor Country ID | |
\return\competitor\duns | DUNS Number | |
\return\competitor\parentDuns | Parent Company DUNS Number | |
\return\competitor\ultimateParentDuns | Ultimate Parent Company DUNS Number | |
\return\competitor\finsales | Annual Sales | |
\return\competitor\companyId | Hoover's Company ID |
7 Company Financial Summary
7.1 Overview
This call returns a summary of finalized financial data for a given company id.
7.2 Input Parameters
Required fields are indicated with.
Field Name | Value | Notes |
uniqueId | Company DUNS Number or Hoover's Company ID |
7.3 Output Parameters
Element Name | Value | Notes |
\return/basicFinancialInformation/companyType | Type of company; public, private, etc. | |
\return/basicFinancialInformation/exchanges | list of exchanges the company is traded on with stock symbol | |
\return/basicFinancialInformation/exchanges/exchange/tickerSymbol | Ticker symbol for the company on the current exchange | |
\return/basicFinancialInformation/exchanges/exchange/exchangeName | Name of the exchange the company is traded on. | |
\return/basicFinancialInformation/ticker | Ticker symbol for the company | |
\return/basicFinancialInformation/location | Type of location for the company; headquarters, branch office, etc. | |
\return/basicFinancialInformation/fiscalYearEnd | Latest fiscal year end | |
\return/basicFinancialInformation/financialFilingsURL | Link to Hoover's Online for financial filings data. | |
\return/basicFinancialInformation/latestYearSales/year | The year for the latest year sales growth. | |
\return/basicFinancialInformation/latestYearSales/sales | The sales number in millions (USD) for the latest year sales growth. | |
\return/basicFinancialInformation/oneYearSalesGrowthPct | The one year sales growth percent. | |
\return/basicFinancialInformation/latestYearNetIncome/year | The year for the current year net income. | |
\return/basicFinancialInformation/latestYearNetIncome/netIncome | The net income for the current year in millions (USD). | |
\return/basicFinancialInformation/oneYearNetIncomeGrowthPct | The one year net income growth percent. | |
\return/basicFinancialInformation/auditor | The name of the financial auditor for this company. | |
\return/basicFinancialInformation/annualReportURL | Company URL to get the annual report for this company. | |
\return/basicFinancialInformation/investorRelationsURL | Company URL to get the investor relations info. | |
\return/annualIncomeStatements/latestYear | Income statement info from the latest year available | |
\return/annualIncomeStatements/previousYears | List of two previous year elements containing income statement information from the years prior to the latest year above. | |
\return/annualIncomeStatements/[previousYears/previousYear | latestYear]/year | The year of the income statement data | |
\return/annualIncomeStatements/[previousYears/previousYear | latestYear]/revenue | The revenue claimed in the income statement data in millions (USD) | |
\return/annualIncomeStatements/[previousYears/previousYear | latestYear]/grossProfit | The gross profit in millions (USD) claimed on the income statement. | |
\return/annualIncomeStatements/[previousYears/previousYear | latestYear]/operatingIncome | The operating income in millions (USD) claimed on the income statement. | |
\return/annualIncomeStatements/[previousYears/previousYear | latestYear]/totalNetIncome | The total net income in millions (USD) claimed on the income statement. | |
\return/annualIncomeStatements/[previousYears/previousYear | latestYear]/dilutedEPS | The diluted earnings per share claimed on the income statement. | |
\return/quarterlyIncomeStatements/latestQuarter | An element containing the latest quarterly income information | |
\return/quarterlyIncomeStatements/previousQuarters | List of previous two quarterly income information happening after the latest quarter above. | |
\return/quarterlyIncomeStatements/[previousQuarters/previousQuarter | latestQuarter]/quarterYear | The year of the quarterly data | |
\return/quarterlyIncomeStatements/[previousQuarters/previousQuarter | latestQuarter]/quarterMonth | The month of the quarterly data | |
\return/quarterlyIncomeStatements/[previousQuarters/previousQuarter | latestQuarter]/revenue | The revenue for the quarter in millions (USD) | |
\return/quarterlyIncomeStatements/[previousQuarters/previousQuarter | latestQuarter]/grossProfit | The gross profit for the quarter in millions (USD) | |
\return/quarterlyIncomeStatements/[previousQuarters/previousQuarter | latestQuarter]/operatingIncome | The operating income for the quarter in millions (USD) | |
\return/quarterlyIncomeStatements/[previousQuarters/previousQuarter | latestQuarter]/totalNetIncome | The total net income for the quarter in millions (USD) | |
\return/quarterlyIncomeStatements/[previousQuarters/previousQuarter | latestQuarter]/dilutedEPS | The diluted earnings per share for the quarter | |
\return/comparisonToIndustryAndMarket | Container for Industry and market comparison info | |
\return/comparisonToIndustryAndMarket/company | Container for company comarison ratio info | |
\return/comparisonToIndustryAndMarket/company/priceSalesRatio | Price Sales Ratio | |
\return/comparisonToIndustryAndMarket/company/priceEarningRatio | Price Earnings Ratio | |
\return/comparisonToIndustryAndMarket/company/priceBookRatio | Price Book Ratio | |
\return/comparisonToIndustryAndMarket/company/priceCashFlowRatio | Price Cash Flow Ratio | |
\return/comparisonToIndustryAndMarket/industryMedian | Container for Industry comparison ratio info | |
\return/comparisonToIndustryAndMarket/industryMedian/priceSalesRatio | Price Sales Ratio | |
\return/comparisonToIndustryAndMarket/industryMedian/priceEarningRatio | Price Earnings Ratio | |
\return/comparisonToIndustryAndMarket/industryMedian/priceBookRatio | Price Book Ratio | |
\return/comparisonToIndustryAndMarket/industryMedian/priceCashFlowRatio | Price Cash Flow Ratio | |
\return/comparisonToIndustryAndMarket/marketMedian | Container for Market comparison ratio info | |
\return/comparisonToIndustryAndMarket/marketMedian/priceSalesRatio | Price Sales Ratio | |
\return/comparisonToIndustryAndMarket/marketMedian/priceEarningRatio | Price Earnings Ratio | |
\return/comparisonToIndustryAndMarket/marketMedian/priceBookRatio | Price Book Ratio | |
\return/comparisonToIndustryAndMarket/marketMedian/priceCashFlowRatio | Price Cash Flow Ratio | |
\return/topCompetitors | Collection of the top 3 competitors for this company. | |
\return/topCompetitors/competitor1 | Competitor Data. | |
\return/topCompetitors/competitor2 | Competitor Data. | |
\return/topCompetitors/competitor3 | Competitor Data. | |
\return/topCompetitors/competitor[1,2, or 3]/companyName | Competitor name. | |
\return/topCompetitors/competitor[1,2, or 3]/annualSales | The sales number in millions (USD) for this competitor. | |
\return/topCompetitors/competitor[1,2, or 3]/employees | The number of employees at this competitor. | |
\return/topCompetitors/competitor[1,2, or 3]/marketCap | Competitor's market cap in millions (USD). | |
\return/annualBalanceSheets | Annual Balance Sheet Data. | |
\return/annualBalanceSheets/latestYear | Balance Sheet info from the latest year available. | |
\return/annualBalanceSheets/previousYears | List of up to possibly two previous year elements containing balance sheet information from the years prior to the latest year above. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/year | The year of the current annual balance sheet data. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/assets | Assets balance sheet data for the year. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/assets/currentAssets | Current asset info associated to this year's balance sheet. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/assets/currentAssets/cash | Cash includes currency on hand as well as demand deposits with banks or financial institutions. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/assets/currentAssets/netRecievables | The sum of all receivables owed by customers and affiliates within one year, including accounts receivable, notes receivable, premiums receivable, and other current receivables. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/assets/currentAssets/inventories | A company's merchandise, raw materials, and finished and unfinished products which have not yet been sold. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/assets/currentAssets/otherIncomeAssets | Other Income Assets includes prepayments, deferred charges, and amounts (other than trade accounts) due from parents and subsidiaries. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/assets/assetSummary | Asset summary info associated with this year's balance sheet | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/assets/assetSummary/totalCurrentAssets | The total amount of assets considered to be convertible into cash within a relatively short period of time, usually a year. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/assets/assetSummary/netFixedAssets | Tangible assets that are held by an entity for use in the production or supply of goods and services, for rental to others, or for administrative purposes and that are expected to provide economic benefit for more than one year; net of accumulated depreciation. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/assets/assetSummary/otherNonCurrentAssets | Assets that are not assigned to Net Fixed Assets or intangibles. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/assets/assetSummary/totalAssets | The total amount of assets considered to be convertible into cash within a relatively short period of time, usually a year. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/liabilities | Liability balance sheet data for the year. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/liabilities/currentLiabilities | Current liability info associated to this year's balance sheet. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/liabilities/currentLiabilities/accountsPayable | Any money that a company owes its suppliers for goods and services purchased on credit and is expected to pay within the next year or operating cycle. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/liabilities/currentLiabilities/shortTermDebt | All borrowings due within one year including current portions of long-term debt and capital leases as well as short-term debt such as bank loans and commercial paper. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/liabilities/currentLiabilities/otherCurrentLiabilities | Other obligations that are due within one year, includes tax payables. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/liabilities/liabilitySummary | Liability summary info associated with this year's balance sheet | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/liabilities/liabilitySummary/totalCurrentLiabilities | The debts or obligations of the firm that are due within one year. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/liabilities/liabilitySummary/longTermDebt | Sum of the carrying values as of the balance sheet date of all long-term debt, which is debt initially having maturities due after one year or beyond the operating cycle, if longer, but excluding the portions thereof scheduled to be repaid within one year or the normal operating cycle, if longer. Long-term debt includes notes payable, bonds payable, mortgage loans, convertible debt, subordinated debt and other types of long term debt. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/liabilities/liabilitySummary/otherNonCurrentLiabilities | Other obligations that are due after one year. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/liabilities/liabilitySummary/totalLiabilities | Probable future sacrifices of economic benefits arising from present obligations of an enterprise to transfer assets or provide services to others in the future as a result of past transactions or events. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/shareholdersEquity | Shareholder's Equity balance sheet data for the year. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/shareholdersEquity/equity | Current Shareholder's Equity info associated to this year's balance sheet. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/shareholdersEquity/equity/preferredStockEquity | Preferred stock (all issues) at par value, as reported within the Shareholder's Equity section of the balance sheet. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/shareholdersEquity/equity/commonStockEquity | Common stock (all issues) at par value, as reported within the Shareholder's Equity section of the balance sheet; i.e. it is one component of Common Shareholder's Equity | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/shareholdersEquity/equitySummary | Shareholder's Equity summary info associated with this year's balance sheet | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/shareholdersEquity/equitySummary/totalEquity | Refers to the ratio of Current Debt and Long Term Debt to Common Equity. | |
\return/annualBalanceSheets/[previousYears/previousYear | latestYear]/shareholdersEquity/equitySummary/sharesOutstanding | The latest total shares outstanding reported by the company; the most common source of this information is from the cover of the 10K, 10Q, or 20F filing. This value is displayed in millions of shares. | |
\return/quarterlyBalanceSheets | Annual Balance Sheet Data. | |
\return/quarterlyBalanceSheets/latestQuarter | Balance Sheet info from the latest quarter available. | |
\return/quarterlyBalanceSheets/previousQuarters | List of up to possibly two previous quarterly elements containing balance sheet information from the quarters prior to the latest quarter above. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/quarterYear | The year of the current quarterly balance sheet data. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/quarterMonth | The month of the current quarterly balance sheet data. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/assets | Assets balance sheet data for the quarter. This value is displayed in millions of shares | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/assets/currentAssets | Current asset info associated to this quarter's balance sheet. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/assets/currentAssets/cash | Cash includes currency on hand as well as demand deposits with banks or financial institutions. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/assets/currentAssets/netRecievables | The sum of all receivables owed by customers and affiliates within one year, including accounts receivable, notes receivable, premiums receivable, and other current receivables. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/assets/currentAssets/inventories | A company's merchandise, raw materials, and finished and unfinished products which have not yet been sold. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/assets/currentAssets/otherIncomeAssets | Other Income Assets includes prepayments, deferred charges, and amounts (other than trade accounts) due from parents and subsidiaries. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/assets/assetSummary | Asset summary info associated to this quarter's balance sheet. This value is displayed in millions of shares. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/assets/assetSummary/totalCurrentAssets | The total amount of assets considered to be convertible into cash within a relatively short period of time, usually a year. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/assets/assetSummary/netFixedAssets | Tangible assets that are held by an entity for use in the production or supply of goods and services, for rental to others, or for administrative purposes and that are expected to provide economic benefit for more than one year; net of accumulated depreciation. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/assets/assetSummary/otherNonCurrentAssets | Assets that are not assigned to Net Fixed Assets or intangibles. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/assets/assetSummary/totalAssets | The total amount of assets considered to be convertible into cash within a relatively short period of time, usually a year. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/liabilities | Liability balance sheet data for the quarter. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/liabilities/currentLiabilities | Current liability info associated to this year's balance sheet. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/liabilities/currentLiabilities/accountsPayable | Any money that a company owes its suppliers for goods and services purchased on credit and is expected to pay within the next year or operating cycle. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/liabilities/currentLiabilities/shortTermDebt | All borrowings due within one year including current portions of long-term debt and capital leases as well as short-term debt such as bank loans and commercial paper. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/liabilities/currentLiabilities/otherCurrentLiabilities | Other obligations that are due within one year, includes tax payables. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/liabilities/liabilitySummary | Liability summary info associated to this quarter's balance sheet. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/liabilities/liabilitySummary/totalCurrentLiabilities | The debts or obligations of the firm that are due within one quarter. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/liabilities/liabilitySummary/longTermDebt | Sum of the carrying values as of the balance sheet date of all long-term debt, which is debt initially having maturities due after one year or beyond the operating cycle, if longer, but excluding the portions thereof scheduled to be repaid within one year or the normal operating cycle, if longer. Long-term debt includes notes payable, bonds payable, mortgage loans, convertible debt, subordinated debt and other types of long term debt. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/liabilities/liabilitySummary/otherNonCurrentLiabilities | Other obligations that are due after one year. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/liabilities/liabilitySummary/totalLiabilities | Probable future sacrifices of economic benefits arising from present obligations of an enterprise to transfer assets or provide services to others in the future as a result of past transactions or events. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/shareholdersEquity | Shareholder's Equity balance sheet data for the quarter. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/shareholdersEquity/equity | Current Shareholder's Equity info associated to this quarter's balance sheet. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/shareholdersEquity/equity/preferredStockEquity | Preferred stock (all issues) at par value, as reported within the Shareholder's Equity section of the balance sheet. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/shareholdersEquity/equity/commonStockEquity | Common stock (all issues) at par value, as reported within the Shareholder's Equity section of the balance sheet; i.e. it is one component of Common Shareholder's Equity | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/shareholdersEquity/equitySummary | Shareholder's Equity summary info associated to this quarter's balance sheet. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/shareholdersEquity/equitySummary/totalEquity | Refers to the ratio of Current Debt and Long Term Debt to Common Equity. | |
\return/quarterlyBalanceSheets/[previousQuarters/previousQuarter | latestQuarter]/shareholdersEquity/equitySummary/sharesOutstanding | The latest total shares outstanding reported by the company; most common source of this information is from the cover of the 10K, 10Q, or 20F filing. This value is displayed in millions of shares. | |
\return/annualCashFlowStatements/latestYear | Cash Flow statement info from the latest year available | |
\return/annualCashFlowStatements/previousYears | List of two previous year elements containing cash flow statement information from the years prior to the latest year above. | |
\return/annualCashFlowStatements/[previousYears/previousYear | latestYear]/year | The year of the cash flow statement data | |
\return/annualCashFlowStatements/[previousYears/previousYear | latestYear]/cashAndCashEquivalentsAtTheBeginningOfTheYear | Cash and cash equivalents for the current year in millions (USD). This amount consists of cash and may include cash-like items such as short-term investments that can be quickly converted to cash. | |
\return/annualCashFlowStatements/[previousYears/previousYear | latestYear]/netCashProvidedByOperatingActivities | Net operating cash flow, cash flow from operations in millions (USD) | |
\return/annualCashFlowStatements/[previousYears/previousYear | latestYear]/netCashProvidedByInvestingActivities | Net investing cash flow in millions (USD) | |
\return/annualCashFlowStatements/[previousYears/previousYear | latestYear]/netCashProvidedByFinancingActivities | Net financing cash flow in millions (USD) | |
\return/annualCashFlowStatements/[previousYears/previousYear | latestYear]/netIncreaseDecreaseInCashAndCashEquivalents | Net change in cash, increase or decrease in cash and cash equivalents from the beginning to the end of a year. | |
\return/annualCashFlowStatements/[previousYears/previousYear | latestYear]/cashAndCashEquivalentsAtTheEndOfTheYear | Cash and cash equivalents for the previous year in millions (USD). This amount consists of cash and may include cash-like items such as short-term investments that can be quickly converted to cash. | |
\return/quarterlyCashFlowStatements/latestQuarter | Cash Flow statement info from the latest quarter available | |
\return/quarterlyCashFlowStatements/previousQuarters | List of two previous quarter elements containing cash flow statement information from the quarters prior to the latest quarter above. | |
\return/quarterlyCashFlowStatements/[previousQuarters/previousQuarter | latestQuarter]/quarterYear | The quarter year of the cash flow statement data | |
\return/quarterlyCashFlowStatements/[previousQuarters/previousQuarter | latestQuarter]/quarterMonth | The quarter month of the cash flow statement data | |
\return/quarterlyCashFlowStatements/[previousQuarters/previousQuarter | latestQuarter]/cashAndCashEquivalentsAtTheBeginningOfTheQuarter | Cash and cash equivalents for the current quarter in millions (USD). This amount consists of cash and may include cash-like items such as short-term investments that can be quickly converted to cash. | |
\return/quarterlyCashFlowStatements/[previousQuarters/previousQuarter | latestQuarter]/netCashProvidedByOperatingActivities | Net operating cash flow, cash flow from operations in millions (USD) | |
\return/quarterlyCashFlowStatements/[previousQuarters/previousQuarter | latestQuarter]/netCashProvidedByInvestingActivities | Net investing cash flow in millions (USD) | |
\return/quarterlyCashFlowStatements/[previousQuarters/previousQuarter | latestQuarter]/netCashProvidedByFinancingActivities | Net financing cash flow in millions (USD) | |
\return/quarterlyCashFlowStatements/[previousQuarters/previousQuarter | latestQuarter]/netIncreaseDecreaseInCashAndCashEquivalents | Net change in cash, increase or decrease in cash and cash equivalents from the beginning to the end of a quarter. | |
\return/quarterlyCashFlowStatements/[previousQuarters/previousQuarter | latestQuarter]/cashAndCashEquivalentsAtTheEndOfTheQuarter | Cash and cash equivalents for the previous quarter in millions (USD). This amount consists of cash and may include cash-like items such as short-term investments that can be quickly converted to cash. |
8 Company Financial Comparison
8.1 Overview
This call returns financial comparison data for a given company id.
8.2 Input Parameters
Required fields are indicated with.
Field Name | Value | Notes |
uniqueId | Company DUNS Number or Hoover's Company ID |
8.3 Output Parameters
Element Name | Value | Notes |
\return/profitabilityComparison | Profitability comparison data for industry median, market median, and the company. | |
\return/profitabilityComparison/[company, industryMedian, or marketMedian]/pctGrossProfitMargin | Gross profit margin. | |
\return/profitabilityComparison/[company, industryMedian, or marketMedian]/pctPreTaxProfitMargin | Pre-tax profit margin. | |
\return/profitabilityComparison/[company, industryMedian, or marketMedian]/pctNetProfitMargin | Net profit margin. | |
\return/profitabilityComparison/[company, industryMedian, or marketMedian]/pctReturnOnEquity | Return on equity. | |
\return/profitabilityComparison/[company, industryMedian, or marketMedian]/pctReturnOnAssets | Return on assets. | |
\return/profitabilityComparison/[company, industryMedian, or marketMedian]/pctReturnOnInvestedCapital | Return on invested capital. | |
\return/valuationComparison | Valuation comparison data for industry median, market median, and the company. | |
\return/valuationComparison/[company, industryMedian, or marketMedian]/priceSalesRatio | Price/Sales ratio. | |
\return/valuationComparison/[company, industryMedian, or marketMedian]/priceEarningsRatio | Price/Earnings ratio. | |
\return/valuationComparison/[company, industryMedian, or marketMedian]/priceBookRatio | Price/Book ratio. | |
\return/valuationComparison/[company, industryMedian, or marketMedian]/priceCashFlowRatio | Price/Cash Flow ratio. | |
\return/operationsComparison | Operations comparison data for industry median, market median, and the company. | |
\return/operationsComparison/[company, industryMedian, or marketMedian]/daysOfSalesOutstanding | Days of sales outstanding. | |
\return/operationsComparison/[company, industryMedian, or marketMedian]/inventoryTurnover | Inventory turnover. | |
\return/operationsComparison/[company, industryMedian, or marketMedian]/daysCostOfGoodsSoldInInventory | Days cost of goods sold in inventory. | |
\return/operationsComparison/[company, industryMedian, or marketMedian]/assetTurnover | Asset turnover. | |
\return/operationsComparison/[company, industryMedian, or marketMedian]/netReceivablesTurnoverFlow | Net receivables turnover flow. | |
\return/operationsComparison/[company, industryMedian, or marketMedian]/pctEffectiveTaxRate | Effective tax rate. | |
\return/financialComparison | Financial comparison data for industry median, market median, and the company. | |
\return/financialComparison/[company, industryMedian, or marketMedian]/currentRatio | Current Ratio | |
\return/financialComparison/[company, industryMedian, or marketMedian]/quickRatio | Quick Ratio | |
\return/financialComparison/[company, industryMedian, or marketMedian]/leverageRatio | Leverage Ratio | |
\return/financialComparison/[company, industryMedian, or marketMedian]/totalDebtToEquity | Total Debt/Equity | |
\return/financialComparison/[company, industryMedian, or marketMedian]/interestCoverage | Interest Coverage | |
\return/perShareDataComparison | Per Share data for industry median, market median, and the company. | |
\return/perShareDataComparison/[company, industryMedian, or marketMedian]/revenuePerShare | Revenue per share. | |
\return/perShareDataComparison/[company, industryMedian, or marketMedian]/dividendsPerShare | Dividends per share. | |
\return/perShareDataComparison/[company, industryMedian, or marketMedian]/cashFlowPerShare | Cash flow per share. | |
\return/perShareDataComparison/[company, industryMedian, or marketMedian]/workingCapitalPerShare | Working capital per share. | |
\return/perShareDataComparison/[company, industryMedian, or marketMedian]/longTermDebtPerShare | Long term debt per share. | |
\return/perShareDataComparison/[company, industryMedian, or marketMedian]/bookValuePerShare | Book value per share. | |
\return/perShareDataComparison/[company, industryMedian, or marketMedian]/totalAssetsPerShare | Total assets per share. | |
\return/growthComparison | Growth Comparison for industry median, market median, and the company. | |
\return/growthComparison/[company, industryMedian, or marketMedian]/pctTwelveMonthRevenueGrowth | 12-Month Revenue Growth | |
\return/growthComparison/[company, industryMedian, or marketMedian]/pctTwelveMonthNetIncomeGrowth | 12-Month Net Income Growth | |
\return/growthComparison/[company, industryMedian, or marketMedian]/pctTwelveMonthEpsGrowth | 12-Month EPS Growth | |
\return/growthComparison/[company, industryMedian, or marketMedian]/pctTwelveMonthDividendGrowth | 12-Month Dividend Growth | |
\return/growthComparison/[company, industryMedian, or marketMedian]/pctThirtySixMonthRevenueGrowth | 36-Month Revenue Growth | |
\return/growthComparison/[company, industryMedian, or marketMedian]/pctThirtySixMonthNetIncomeGrowth | 36-Month Net Income Growth | |
\return/growthComparison/[company, industryMedian, or marketMedian]/pctThirtySixMonthEpsGrowth | 36-Month EPS Growth | |
\return/growthComparison/[company, industryMedian, or marketMedian]/pctThirtySixMonthDividendGrowth | 36-Month Dividend Growth |
9 Company Market Data
9.1 Overview
This call returns financial market data for a given company id.
9.2 Input Parameters
Required fields are indicated with.
Field Name | Required | Notes |
uniqueId | Company DUNS Number or Hoover's Company ID |
9.3 Output Parameters
Element Name | Value | Notes |
\return/currentInformation/lastCloseDate | Date of the reported last close price. | |
\return/currentInformation/lastCloseAmount | The reported last close price. | |
\return/currentInformation/fiftyTwoWeekHigh | The fifty two week stock price high. | |
\return/currentInformation/fiftyTwoWeekLow | The fifty two week stock price low. | |
\return/currentInformation/sixtyMonthBeta | The sixty month beta. | |
\return/currentInformation/marketCap | The market cap for the company in millions. | |
\return/currentInformation/sharesOutstanding | The shares outstanding for the company in millions. | |
\return/currentInformation/dividendRate | The dividend rate for the company. | |
\return/currentInformation/dividendYield | The dividend yield for the company. | |
\return/currentInformation/numOfInstitutionalHolders | The number of institutions owning this companies stock. | |
\return/currentInformation/latestShortInterestRatio | The short interest ratio for this company. | |
\return/currentInformation/priceSalesRatio | Price to sales ratio. | |
\return/currentInformation/priceBookRatio | Price to book ratio. | |
\return/currentInformation/priceEarningsRatio | Price to earnings ratio. | |
\return/currentInformation/priceCashFlowRatio | Price to cash flow ratio. | |
\return/currentInformation/pctReturnOnAssets | Return on assets as a percentage. | |
\return/currentInformation/pctReturnOnEquity | Return on equity as a percentage. | |
\return/currentInformation/currentRatio | Current ratio for this company. | |
\return/currentInformation/longTermDebtToEquity | Long term debt to equity ratio for this company. | |
\return/currentInformation/pctOwnedByInstitutions | Percentage of the company stock owned by institutions. | |
\return/currentInformation/latestNetInsiderTransactions | The amount of recent insider transactions. | |
\return/growthRates/[twelveMonth OR thirtySixMonth OR sixtyMonth]/pctRevenueGrowth | Percentage of revenue growth for 12, 36, and 60 months respectively. | |
\return/growthRates/[twelveMonth OR thirtySixMonth OR sixtyMonth]/pctEpsGrowth | Percentage of EPS growth for 12, 36, and 60 months respectively. | |
\return/growthRates/[twelveMonth OR thirtySixMonth OR sixtyMonth]/pctDividendGrowth | Percentage of dividend growth for 12, 36, and 60 months respectively. |
10 Get Hoover's Links
10.1 Overview
This call returns a set of links to premium company information available in Hoover's Online.
10.2 Input Parameters
Required fields are indicated with.
Field Name | Value | Notes |
uniqueId | Company DUNS Number or Hoover's Company ID |
10.3 Output Parameters
Element Name | Value | Notes |
\return/companyHooversLinks/companyOverviewLink | Company Overview page | |
\return/companyHooversLinks/competitiveLandscapeLink | Detailed Cometitive Landscape page | |
\return/companyHooversLinks/financialSummaryLink | Full Financials page | |
\return/companyHooversLinks/productsAndOperationsLink | Products & Operations page | |
\return/companyHooversLinks/companyDescriptionLink | Full Description page | |
\return/companyHooversLinks/newsListLink | Company News List page |
11 Get Company News
11.1 Overview
Returns news items for a given DUNS number. News requires a valid username and password.
11.2 Input Parameters
Field Name | Value | Notes |
duns | The DUNS number of the company to query for news items | |
filter | An optional category filter. For a list of values, see the WSDL | |
startDate | A date used to filter news items. Restricts to news items on or after the date | |
endDate | A date used to filter news items. Restricts to news items on or before the date |
11.3 Output Parameters
Field Name | Value | Notes |
companyNews/duns | The DUNS number of the company | |
companyNews/name | The name of the company | |
companyNews/newsItems | The list of news items. | |
companyNews/newsItem/date | The timestamp for the news item | |
companyNews/newsItem/source | The publication source for the news item | |
companyNews/newsItem/category | A broad-based category for the news item. Can appear multiple times | Categories can be found in the WSDL |
companyNews/newsItem/title | The title of the news item | |
companyNews/newsItem/text | The body of the news item | |
companyNews/newsItem/link | The link for the original news item |
- Versions
- Version 3.0
- Version 3.1
- Version 3.2
- Version 3.3
- Version 3.4
- Version 4.0
- Version 3.2 Documentation
- Overview
- Security
- Queries - Company Information
- Queries - Person Information
- Queries - Industry Information
- Queries - Lookup Information
- Queries - Personalization
- Queries - Company Information