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:
  • Company (sorts by relevance; this is the default)
  • CompanyName
  • CityName
  • StateName
  • CountryName
  • SalesUS
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
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