Hoover's API Version 4.0 - Company REST

Queries - REST - Company Information

IMPORTANT: All calls on this page require an Username , Password, API key

New features are highlighted.

1 Get Company Detail Simple - /company/{unique_id}

1.1 Overview

Returns a reduced subset of company details for a given Hoover's Company ID or DUNS

1.2 Input URI

This is a "GET" only call.

HTTP Methods accepted Context Path Headers Sample URL
GET HooversAPI-40/rest "username" and "password" HTTP headers are mandatory http://hapi.hoovers.com/HooversAPI-40/rest/company/13193000000000?view=simple

1.3 Input Parameters

[application/json] - Required fields are indicated with .

The query and path parameters as listed below.

Path parameters Sample Path parameters Query parameters Sample Query parameters
company/{unique_id} company/13193000000000 view={view} view=simple (This value is case sensitive)

1.4 Output Parameters

Field Name Type Values(s)
name: String company name
companyId: Number Hoovers Company ID
nonMarketableCompany Object This object contains child tags representing the reasons for which this company is taged as non-marketable.
nonMarketableCompany{ reasons String value The possible reasons are
  • Out of business
  • Invalid address
  • Key data missing/needing revision
  • Donot market to
primaryLocation: Object JSON object used to wrap location information
primaryLocation:{ address1: String Company Address1
primaryLocation:{ address2: String Company Address2
primaryLocation:{ city: String Company City
primaryLocation:{ country: String Company Country. returns name of country instead of ID
primaryLocation:{ state: String Company State
primaryLocation:{ zip: String Postal code
primaryLocation:{ zip4: String Postal code
primaryLocation:{ latitude: decimal Latitude
primaryLocation:{ longitude: decimal longitude
primaryLocation:{ latLongAccuracy: decimal latLongAccuracy
primaryPhone Object JSON object used to wrap phone information
primaryPhone:{ countryCode: String Address Country ID
primaryPhone:{ areaCode: String Phone Number Area Code
primaryPhone:{ phoneNumber: String Phone Number
primaryPhone:{ doNotCallRegistry: Boolean Indicates whether company is listed on a UK Do Not Call registry
primaryURL: String Primary URL for the company
legalStatus: String Legal Status description for the company
yearFounded: String Year the company was founded
minorityOwned: Boolean Indicates if the company is owned by a minority
womenOwned: Boolean Indicates if the company is owned by women

2 Get Company Detail Basic - /company/{unique_id}

2.1 Overview

Returns a reduced subset of company details for a given Hoover's Company ID or DUNS

2.2 Input URI

This is a "GET" only call.

HTTP Methods accepted Context Path Headers Sample URL
GET HooversAPI-40/rest "username" and "password" HTTP headers are mandatory http://hapi.hoovers.com/HooversAPI-40/rest/company/13193000000000?view=basic

2.3 Input Parameters

[application/json] - Required fields are indicated with.

The query and path parameters as listed below.

Path parameters Sample Path parameters Query parameters Sample Query parameters.
company/{unique_id} company/13193000000000 view={view} view=basic (This value is case sensitive)

2.4 Output Parameters

Name Type Value(s)
company: Object Top level JSON object used to wrap Company output data.
company: { name: String Company name
company: { duns: Number DUNS Number
company: { companyId: Number Hoovers Company ID
company: { address1: String Company Address1
company: { address2: String Company Address2
company: { city: String Company City
company: { state: String Company State
company: { zip: String Postal code
company: { zip4: String Postal code
company: { country: String Company Country
company: { latitude: Number Company geo-located latitdue
company: { longitude: Number Company geo-located longitude
company: { phoneNumber: String Phone Number
company: { doNotCallRegistry: Boolean Indicates whether company is listed on a UK Do Not Call registry
company: { companyType: String Company Type
company: { locationType: String Company Location Type
company: { ultimateParentDuns: String Company's Parent DUNs
company: { ultimateParentName: String Company's Parent Name
company: { url: String Primary URL for the company
company: { annualSales: Number Copmany's Total Annual Sales
company: { marketingPrescreenScore: String Marketing pre-screen scores. Value of either 'L' Low, 'M' Medium or 'H' High
company: { hic: String Hoovers's Industry Code
company: { naics: String NAICS Code
company: { ussic: String US SIC Code
company: { uksic: String UK SIC Code

3 Get Company Detail Full - /company/{unique_id}

3.1 Overview

Returns all the company details for a given Hoover's Company ID or DUNS

3.2 Input URI

This is a "Get" only call.

HTTP Methods accepted Context Path Headers Sample URL
GET HooversAPI-40/rest "username" and "password" HTTP headers are mandatory http://hapi.hoovers.com/HooversAPI-40/rest/company/13193000000000?view=full

3.3 Input Parameters

[application/json] - Required fields are indicated with .

The query and path parameters as listed below.

Path parameters Sample Path parameters Query parameters Sample Query parameters.
company/{unique_id} company/13193000000000 view={view} view=full (value is case sensitive)

3.4 Output Parameters

Name Type Value(s)
companyId: Number Hoovers Company ID
duns: Number Duns number of this company.
companyType: String Company Type such as Public, Private, etc
locationType: String Company Location Type such as Head Quarters, Single Location, etc
ultimateParentDuns: Number The Ultimate Parent DUNS number
ultimateParentName: String The Ultimate Parent name corresponding to the ultimate parent DUNS number
parentDuns: Number Hoover's ID of the company's immediate parent
parentName: String Company name of this company's immediate parent.
name: String Company Name
nonMarketableCompany Object This object contains child tags representing the reasons for which this company is taged as non-marketable.
nonMarketableCompany{ reasons String value The possible reasons are
  • Out of business
  • Invalid address
  • Key data missing/needing revision
  • Donot market to
dbaNames: Object JSON object wrapping dbaNames
dbaNames:{ dbas[]: List Array of Strings depicting Doing Business As
industries: Object JSON object that wraps all the industries information.
industries:{ primaryHIC: String HIC Code
industries:{ primaryNAICS: String NAICS Code
industries:{ primaryUSSIC: String US SIC Code
industries:{ primaryUKSIC: String Primary UK SIC Code
industries:{ allUKSIC: JSON Object JSON Object containing all the UK SIC Codes
industries:allUKSIC:{ items[]: List Collection of all UK SIC Codes and descriptions.
industries:allUKSIC:items:{ code: String UK SIC Code
industries:allUKSIC:items:{ description: String Description of industry referred to
industries:{ allUSSIC: JSON Object JSON object wrapping all US SIC Codes
industries:allUSSIC:{ items[]: List Collection of all US SIC Codes
industries:allUSSIC:items:{ ussic: String US SIC Code
industries:allUSSIC:items:{ description: String Description of the industry represented by the USSIC
industries:{ allHIC: JSON Object JSON Object wrapping all Hoovers Industry Codes
industries:allHIC:{ items[]: List Collection of all Hoovers Industry Codes
industries:allHIC:items:{ hic: String Hoovers Industry Code
industries:allHIC:items:{ description: String Description of the industry represented by the HIC
industries:{ allNAICS: JSON Object JSON Object wrapping all the NAICS codes for the company
industries:allNAICS:{ items: List Collection NAICS codes for the company
industries:allNAICS:items:{ naics: String NAICS code
industries:allNAICS:items:{ description: String Description of the industry represented by the NAICS
subsidiaryStatus: Boolean Subsidiary Status
keyNumbersHistory: JSON Object JSON object wrapping all the history of Key Numbers
keyNumbersHistory:{ annualKeyNumbersHistory: JSON Object JSON Object wrapping all the Annual Financial Figures
keyNumbersHistory:{ quarterlyKeyNumbersHistory: JSON Ojbect JSON Object wrapping all the Quarterly Financial Figures
keyNumbersHistory: annualKeyNumbersHistory|quarterlyKeyNumbersHistory:{ keyNumbers: List Financial Figures
keyNumbersHistory: annualKeyNumbersHistory|quarterlyKeyNumbersHistory:keyNumbers:{ sales: Decimal Annual Sales. This value is in US Dollars.
keyNumbersHistory: annualKeyNumbersHistory|quarterlyKeyNumbersHistory:keyNumbers:{ employeesAtThisLocation: Number Employees at this Location
keyNumbersHistory: annualKeyNumbersHistory|quarterlyKeyNumbersHistory:keyNumbers:{ totalEmployeeGrowthPercent: Decimal Total Employee Growth % for the Year
keyNumbersHistory: annualKeyNumbersHistory|quarterlyKeyNumbersHistory:keyNumbers:{ researchAndDevelopment: Decimal R&D Expenses for the Year. This value is in US Dollars.
keyNumbersHistory: annualKeyNumbersHistory|quarterlyKeyNumbersHistory:keyNumbers:{ advertising: Decimal Advertising Expenses for the Year. This value is in US Dollars.
keyNumbersHistory: annualKeyNumbersHistory|quarterlyKeyNumbersHistory:keyNumbers:{ employeesTotal: Number Total Employees
keyNumbersHistory: annualKeyNumbersHistory|quarterlyKeyNumbersHistory:keyNumbers:{ fiscalPeriod: String Fiscal Period
keyNumbersHistory: annualKeyNumbersHistory|quarterlyKeyNumbersHistory:keyNumbers:{ periodEndMonth: String Period End Month
locations JSON Object JSON object wrapping all the Company Addresses
locations:{ locations: List List containg all the locations
locations:locations:{ address1: String Company Address
locations:locations:{ address2: String Company Address Line 2
locations:locations:{ city: String Company City
locations:locations:{ county: String Company County
locations:locations:{ state: String Company State
locations:locations:{ country: String Company Country Name
locations:locations:{ countryId: Number Company Country ID
locations:locations:{ zip: String Company Zip Code
locations:locations:{ zip4: String Company Zip Plus 4
locations:locations:{ latitude: Decimal Latitude
locations:locations:{ longitude: Decimal Longitude
locations:locations:{ latLongAccuracy: String Accuracy of latitude and longitude
locations:locations:{ addressType: String Address Type such as Primary, Headquarters, Mailing etc.
locations:locations:{ metroArea: String The metorpolitan area for the location
ownershipYear: String Ownership Year
phones: JSON Object Company Phone Numbers
phones:{ phoneNumbers| faxNumbers[]: List Company Phone Numbers. Phone as well as faxNumbers are now under this element.
phones: phoneNumber|faxNumber:{ areaCode: String Phone Number Area Code
phones:phoneNumber| faxNumber:{ countryCode: String Address Country ID
phones:phoneNumber| faxNumber:{ phoneNumber: String Phone Number
phones:phoneNumber| faxNumber:{ doNotCallRegistry: Boolean Indicates whether company is listed on a UK Do Not Call registry
synopsis: String Company Description
full-description: String Full Company Description
historicalIndicator: Boolean Flag to Indicate Boneyard Company. True means Boneyard Company
historicalText String Brief description of why the company is defunct
stocks: JSON Object JSON Ojbect wrapping all the Ticker information for this company.
stocks:{ tickerUS: String Ticker Symbol used for this company.
stocks:{ exchangeInfoList: JSON Object JSON Object wrapping all the Exchange information.
stocks:exchangeInfoList:{ exchangeInfos[]: List List of exchange information.
stocks:exchangeInfoList:exchangeInfos:{ country: String Country name where exchange is located.
stocks:exchangeInfoList:exchangeInfos:{ tickerSymbol: String Ticker Symbol used for this company in this exchange.
stocks:exchangeInfoList:exchangeInfos:{ exchangeName: String Exchange name where this company is traded.
topExecutives JSON Object JSON Object wrapping Top 3 Company Executives
topExecutives:{ officials[]: List List of Top Executives
topExecutives:officials:{ coOfficialId: Number Hoovers Official ID
topExecutives:officials:{ latestPosition: String Most recent position information
topExecutives:officials:latestPosition:{ title: String Person Title
topExecutives:officials:latestPosition:{ startYear: String Latest position start year
topExecutives:officials:latestPosition:{ endYear: String Latest position end year
topExecutives:officials:{ latestSalary: JSON Object JSON Object containg the most recent salary information
topExecutives:officials:latestSalary:{ year: Number Latest salary year
topExecutives:officials:latestSalary:{ salary: Decimal Salary for the year, excluding bonus in USD
topExecutives:officials:latestSalary:{ totalSalary: Decimal Total compensation for the year, including any bonus or other compensation in USD
topExecutives:officials:latestSalary:{ bonus: Decimal Bonus for the year, in USD
topExecutives:officials:{ person: JSON Object Most recent salary information
topExecutives:officials:person:{ fullName: String Person Full Name
topExecutives:officials:person:{ lastName: String Person Last Name
topExecutives:officials:person:{ firstName: String Person First Name
topExecutives:officials:person:{ middleName: String Person Middle Name
topExecutives:officials:person:{ suffix: String Person Suffix
topExecutives:officials:person:{ prefix: String Person Prefix
topExecutives:officials:person:{ age: Number Person Age
topExecutives:officials:connectMail JSON Object Wrapper element for ConnectMail indicators
topExecutives:officials:connectMail:{ connectMailNameSource: Boolean Indicates if official's name is a ConnectMail contact
topExecutives:officials:connectMail:{ connectMailEmailSource: Boolean Indicates if official's email is a ConnectMail contact
topExecutives:officials:connectMail:{ connectMailPhoneSource: Boolean Indicates if official's phone number is a ConnectMail contact
familyTreeLink String Corporate Family Tree Link
primaryURLs JSON Object Company Primary URLs in sorted in ascending order
primaryUrls:{ primaryUrls[]: List List of primary url information
primaryUrls:primaryUrls:{ sortOrder: Number A number indicating the relative order of the accompanying url among all primary urls
primaryUrls:primaryUrls:{ url: String A primary url for a company
otherURLs: JSON Object JSON Object wrapping information about other Company Urls
otherURLs:{ urls[]: List List of Company urls
accountingFirm: String The accounting firm/auditor for this company.
bankName: String The bank name for this company.
marketingPreScreenScore: String The D&B Marketing Prescreen value for this company.
keyFinancials: JSON Object JSON Object wrapping all the market value and income asset information.
keyFinancials:{ marketValueInfo: JSON Object Contains market value information
keyFinancials:marketValueInfo:{ marketValue: Decimal Market value (in millions of USD) of this company.
keyFinancials:marketValueInfo:{ marketValueDate: Date Date of market valuation.
keyFinancials:{ incomeAssets: JSON Object Contains income asset information.
keyFinancials:incomeAssets:{ period: String Fiscal Period reporting date.
keyFinancials:incomeAssets:{ assets: Decimal Total assets (in millions of USD) of this company.
keyFinancials:incomeAssets:{ salesGrowthPercent: Decimal Sales growth in percent for this company.
keyFinancials:incomeAssets:{ netIncome: Decimal Net income (in millions of USD) of this company.
keyFinancials:incomeAssets:{ netIncomeGrowthPercent: Decimal Net income growth in percent of this company.
ukSpecs: JSON Object UK-specific information.
ukSpecs:{ uKRegistration: String UK Registration Number. e.g. 4044056 or 4044056, 0764797
ukSpecs:{ uKVAT: String UK Vat Number. e.g. 906565610 or 906565610, 466264724
ukSpecs:{ numberOfSubsidiaries: JSON Object Number of subsidiaries
ukSpecs:numberOfSubsidiaries:{ domestic: Number Number of subsidiaries in the UK
numberOfPCs: Number Number of PCs at the company
spaceAtAddress: Number Space in square feet at the location
spaceAtAddressUnitOfMeasurement: String Unit of measurement for spaceAtAddress
spaceAtAddressAccuracy: Number Accuracy of spaceAtAddress field
ownedOrLeased: String Indicates if the company's location is owned/leased
manufacturingIndicator: String Indicates if the company is a manufacturer
legalStatus: String Legal Status description for the company
yearFounded: String Year the company was founded
minorityOwned: Boolean Indicates if the company is owned by a minority
ethnicity: String Ethnicity of business owner.
womenOwned: Boolean Indicates if the company is owned by women
rankings: JSON Object A list of rankings for the company such as Fortune 500
rankings:{ ranks: List A list of rankings for the company such as Fortune 500. It is a Json object
rankings:ranks{ rankNumber: Number Within a particular ranking this is the companies rank, such as number 100 on the Fortune 500
rankings:ranks{ definition: String The name of the ranking, such as Fortune 500

4 Advanced Company Search - search/company/advanced

4.1 Overview

Returns search result of companies based on varying different criteria

4.2 Input URI

This is a "POST" only call not requiring any query or path parameters other than listed.

HTTP Methods Accepted Context Path Headers Sample URL
POST HooversAPI-40/rest "username" and "password" HTTP headers are mandatory http://hapi.hoovers.com/HooversAPI-40/rest/search/company/advanced?hit_offset=0&max_records=20&sort_direction=ascending&order_by=company_name

4.3 Input Parameters

4.3.1 Path Parameters

All path parameters are named in lowercase, with an underscore separator for multiple words.

Path Parameter Sample Type Value(s)
N/A N/A N/A N/A

4.3.2 Query Parameters

All query parameters are named in lowercase, with an underscore separator for multiple words.

Query Parameter Sample Type Value(s)
hit_offset={hit_offset} hit_offset=0 Number 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 zero-based.
max_records={max_records} max_records=20 Number Between 1-200. Default = 20
sort_direction={sort_direction} sort_direction=ascending String Default sort direction is ascending. Other values for this search include:
  • ascending
  • descending
return_search_navigation={return_search_navigation} return_search_navigation=false Boolean Default return search navigation is false. Other values for this search include:
  • false
  • true
order_by={order_by} order_by=company_name String Default order by is relevance. Other values for this search include:
  • company_name
  • company_type
  • country_name
  • city_name
  • state_name
  • phone_number
  • fax_number
  • sales_growth_12_mon
  • total_assets
  • sales_us
  • employees_total
  • employees_here
  • fiscal_year_end_month
  • merket_cap
  • net_income_growth_12_mon
  • employee_growth_12_mon
  • roe
  • roa
  • earnings_compairson
  • book_value_comparison
  • net_income
  • person_first_name
  • person_last_name
  • person_title

4.3.3 JSON Entity

Media type 'application/json'

Name Type Value(s)
companySize: Object Top level JSON object used to wrap CompanySize input data.
companySize: { employeesFrom: Number Total Employees Lower Bound
companySize: { employeesTo: Number Total Employees Upper Bound
companySize: { employeesGrowthFrom: Number Total Employees Growth Percentage Lower Bound
companySize: { employeesGrowthTo: Number Total Employees Growth Percentage Upper Bound
companySize: { employeesThisLocationFrom: Number Employees at this Location Lower Bound
companySize: { employeesThisLocationTo: Number Employees at this Location Upper Bound
companySize: { marketCapFrom: Number Market Cap ($ mil) Lower Bound
companySize: { marketCapTo: Number Market Cap ($ mil) Upper Bound
companySize: { salesFrom: Number Annual Sales ($ mil) Lower Bound
companySize: { salesTo: Number Annual Sales ($ mil) Upper Bound
companySize: { salesGrowthFrom: Number Annual Sales Growth (%) Lower Bound
companySize: { salesGrowthTo: Number Annual Sales Growth (%) Upper Bound
companyType: Object Top level JSON object used to wrap CompanyType input data.
companyType: { locationType: [n,n...] Array of Numbers ID Value from GetAdvancedSearchLookups<
companyType: { ownershipType: [n,n...] Array of Numbers Values are 1 (Public), 21 (Owned by a Public Company) or 0 (Non-Public)
companyType: { subsidiaryStatus: [n,n...] Array of Numbers Subsidiary or Not a Subsidiary
companyType: { franchiseStatus: [n,n...] Array of boolean Set the value to true for searching Franchise and false to Not a Franchise
financialData: Object Top level JSON object used to wrap FinancialData input data.
financialData: { advertisingExpenseFrom: Number Ad Expense ($ mil) Lower Bound.
financialData: { advertisingExpenseTo: Number Ad Expense ($ mil) Upper Bound.
financialData: { assetsFrom: Number Assets ($ mil) Lower Bound.
financialData: { assetsTo: Number Assets ($ mil) Upper Bound.
financialData: { filingDateFrom: String Filing Date Lower Bound. Format - YYYY-MM-DD
financialData: { filingDateTo: String Filing Date Upper Bound. Format - YYYY-MM-DD
financialData: { fiscalYearEnd: Array of Numbers Fiscal Year End Month
financialData: { incomeFrom: Number Net Income ($ mil) Lower Bound.
financialData: { incomeGrowthFrom: Number Net Income Growth (%) Lower Bound
financialData: { incomeGrowthTo: Number Net Income Growth (%) Upper Bound
financialData: { incomeTo: Number Net Income ($ mil) Upper Bound
financialData: { marketingPreScreenScore: Array of Strings Values of either 'l' Low, 'm' Medium or 'h' High accepted. Allows for unique combinations of the preseeding values from 0 to 3.
financialData: { offerFrom: Number US IPO Data - Offer Amount ($ mil.) Lower Bound
financialData: { offerTo: Number US IPO Data - Offer Amount ($ mil.) Upper Bound
financialData: { priceRangeFrom: Number US IPO Data - Price Range ($) Lower Bound
financialData: { priceRangeTo: Number US IPO Data - Price Range ($) Upper Bound
financialData: { researchExpenseFrom: Number R&D Expense ($ mil) Lower Bound
financialData: { researchExpenseTo: Number R&D Expense ($ mil) Upper Bound
financialData: { tradingDateFrom: String Trading Date Lower Bound. Format - YYYY-MM-DD
financialData: { tradingDateTo: String Trading Date Upper Bound. Format - YYYY-MM-DD
financialData: { underwriterId: Array of Numbers ID Value from GetAdvancedSearchLookups It searches only the lead underwriter for the given underwriterId.
industry: Object Top level JSON object used to wrap Industry input data.
industry: { hooversIndustryCode: Array of Strings ID Value from GetAdvancedSearchLookups
industry: { primaryOnly: Boolean Primary Industry Only
industry: { nAICS: Array of Strings Enter at least two digits per code. No CSV or Ranges can be specified
industry: { nAICSRange:[ {from:,to:}... ] Array of Objects Enter one or more range object. Each range object must contain 'from' and a 'to' object.
industry: { uSSIC: Array of Strings Enter at least two digits per code. No CSV or Ranges can be specified
industry: { uSSICRange:[ {from:,to:}... ] Array of Objects Enter one or more range object. Each range object must contain 'from' and a 'to' object.
industry: { uKSIC: Array of Strings Enter at least two digits per code. No CSV or Ranges can be specified
industry: { uKSICRange:[ {from:,to:}... ] Array of Objects Enter one or more range object. Each range object must contain 'from' and a 'to' object.
location: Object Top level JSON object used to wrap Location input data.
location: { areacode: Array of Strings US/Canada Area Code
location: { streetAddress: Array of Strings Street Address - e.g. 1700 Pennsylvania Ave.
location: { county: Array of county Objects  
location: { county: { countyId: String ID Value from GetAdvancedSearchLookups
location: { county: { state: String ID Value from GetAdvancedSearchLookups
location: { county: { countryId: String ID Value from GetAdvancedSearchLookups
location: { city: Array of Strings City - e.g. Madrid or New York
location: { countryId: Array of Numbers ID Value from GetAdvancedSearchLookups
location: { globalState: Array of Strings Global State/Province - e.g Queensland or NY
location: { metropolitanId: Number US Metropolitan Area - ID Value from GetAdvancedSearchLookups
location: { regionId: Array of Numbers World Region - ID Value from GetAdvancedSearchLookups
location: { usStateCanadaProvince: Array of Strings US State/Canada Province
location: { postalCode: Array of Strings Postal Code - e.g. 78701 or "SW1P 1JA" or "SW1"
location: { usZipCodeRange: Array of Objects Top level JSON object used to wrap USZipCodeRange input data.
location: { usZipCodeRange: { from: Number US ZIP Code Lower Bound
location: { usZipCodeRange: { to: Number US ZIP Code Upper Bound
location: { zipAreaSearch: Object Top level JSON object used to wrap ZipAreaSearch input data.
location: { zipAreaSearch: { scale: String 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.
  • miles
  • kilometers
location: { zipAreaSearch: { radius:: Number # 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.
location: { zipAreaSearch: { zipCode: String 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.
location: { latLongSearch: Object Top level JSON object used to wrap LatLongSearch input data.
location: { latLongSearch: { scale: String Units to search in: miles or kilometers
  • miles
  • kilometers
Requires radius, latitude, and longitude.
location: { latLongSearch: { radius: Number # of miles or kilometers to search within. Requires scale, latitude, and longitude.
location: { latLongSearch: { latitude: Number latitude. Requires scale, radius, and longitude.
location: { latLongSearch: { longitude: Number longitude. Requires scale, radius, and latitude.
location: { allAny: String 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
  • all
  • any
location: { ukCounty: Array of Strings A valid UK county name
specialtyCriteria: Object Top level JSON object used to wrap SpecialtyCriteria input data.
specialtyCriteria: { auditorId: Array of Numbers ID Value from GetAdvancedSearchLookups
specialtyCriteria: { companyKeyword: String Company Keyword - e.g. laptops or China or acquired, merged, takeover
specialtyCriteria: { duns: Array of Numbers DUNS Number. The duns number must not be more than 9 digits.
specialtyCriteria: { exchangeId: Array of Numbers ID Value from GetAdvancedSearchLookups
specialtyCriteria: { rankingId: Array of Numbers ID Value from GetAdvancedSearchLookups
specialtyCriteria: { ukRegistration: Array of Strings UK Registration Number - e.g. 4044056
specialtyCriteria: { ukVat: Array of Strings UK Vat Number - e.g. 906565610
specialtyCriteria: { yearFoundingFrom: Number Year of Founding or Change in Control Lower Bound. Format - YYYY
specialtyCriteria: { yearFoundingTo: Number Year of Founding or Change in Control Upper Bound. Format - YYYY
specialtyCriteria: { ultimateParentDuns: Array of Numbers The ultimate parent DUNS number for a family of companies - eg. 060902413 or 884364530
specialtyCriteria: { primaryUrl: Array of Strings Primary URL
specialtyCriteria: { companyName: String Company Name
specialtyCriteria: { minorityOwned: Boolean Minority Owned Company (true/false)
specialtyCriteria: { womenOwned: Boolean Women Owned Company (true/false)
specialtyCriteria: { squareFootageFrom: Number Company square foot range from
specialtyCriteria: { squareFootRangeTo: Number Company square foot range to
specialtyCriteria: { ethnicity: Array of Strings Ethnicity of the company owner
  • asn
  • blk
  • hsp
  • isu
  • nat
  • unk
specialtyCriteria: { legalStatus: Array of Strings Legal Status of the company
  • corporation
  • partnership
  • proprietorship
  • national_government_entity
  • regional_local_government_entity
  • joint_venture
  • non_profit_organization
  • co_operative_mutual_organization
  • foreign_company
specialtyCriteria: { ownedOrRented: String Company resides in Owned or Rented Space
  • owned
  • rented
searchNavigation: Object Top level JSON object used to wrap Search Navigation input data.
searchNavigation: { employeeSearchNavigation: Object Top level JSON object used to wrap Employee Search Navigation input data.
searchNavigation { employeeSearchNavigation: { employeeSearchNavigationValue: Array of Strings Value from GetAdvancedSearchLookups
searchNavigation: { ownershipTypeSearchNavigation: Object Top level JSON object used to wrap OwnerShip type Search Navigation input data.
searchNavigation { ownershipTypeSearchNavigation: { ownershipTypeSearchNavigationValue: Array of Strings Value from GetAdvancedSearchLookups
searchNavigation: { locationTypeSearchNavigation: Object Top level JSON object used to wrap Location type Search Navigation input data.
searchNavigation { locationTypeSearchNavigation: { locationTypeSearchNavigationValue: Array of Strings Value from GetAdvancedSearchLookups
searchNavigation: { salesSearchNavigation: Object Top level JSON object used to wrap sales Search Navigation input data.
searchNavigation { salesSearchNavigation: { salesSearchNavigationValue: Array of Strings Value from GetAdvancedSearchLookups
searchNavigation: { locationSearchNavigation: Object Top level JSON object used to wrap Location Search Navigation input data.
searchNavigation { locationSearchNavigation: { countryNavigation: Object Top level JSON object used to wrap Country Navigation input data.
searchNavigation { locationSearchNavigation { countryNavigation: { countryNavigationValue: String Value from GetAdvancedSearchLookups
searchNavigation { locationSearchNavigation { countryNavigation: { stateNavigation: Object Top level JSON object used to wrap State Navigation input data.
searchNavigation { locationSearchNavigation { countryNavigation { stateNavigation: { stateNavigationValue: Array of Strings Value from GetAdvancedSearchLookups
searchNavigation { locationSearchNavigation { countryNavigation { stateNavigation: { cityNavigation: Object Top level JSON object used to wrap City Navigation input data.
searchNavigation { locationSearchNavigation { countryNavigation { stateNavigation { cityNavigation: { cityNavigationValue: Array of Strings Value from GetAdvancedSearchLookups
searchNavigation: { industrySearchNavigation: Object Top level JSON object used to wrap sales Industry Navigation input data.
searchNavigation { industrySearchNavigation: { industrySearchNavigationValue: Array of Strings Value from GetAdvancedSearchLookups
searchNavigation { industrySearchNavigation: { ussicSearchNavigationValue: Array of Strings Value from GetAdvancedSearchLookups
searchNavigation { industrySearchNavigation: { naicsSearchNavigationValue: Array of Strings Value from GetAdvancedSearchLookups

4.3.4 Sample JSON for POST - contains ALL fields with invalid values, only use what you need

    
{
    "companySize":{
        "employeesFrom":n,
        "employeesTo":n,
        "employeesGrowthFrom":n,
        "employeesGrowthTo":n,
        "employeesThisLocationFrom":n,
        "employeesThisLocationTo":n,
        "marketCapFrom":n,
        "marketCapTo":n,
        "salesFrom":n,
        "salesTo":n,
        "salesGrowthFrom":n,
        "salesGrowthTo":n,
    },
    "companyType":{
        "locationType": [n,n...],
        "ownershipType": [n,n...],
        "subsidiaryStatus": [n,n...]
    },
    "financialData":{
        "advertisingExpenseFrom":n,
        "advertisingExpenseTo":n,
        "assetsFrom":n,
        "assetsTo":n,
        "filingDateFrom":"",
        "filingDateTo":"",
        "fiscalYearEnd":[n,n,...],
        "incomeFrom":n,
        "incomeGrowthFrom":n,
        "incomeGrowthTo":n,
        "incomeTo":n,
        "marketingPrescreenScore":["","",...],
        "offerFrom":n,
        "offerTo":n,
        "priceRangeFrom":n,
        "priceRangeTo":n,
        "researchExpenseFrom":n,
        "researchExpenseTo":n,
        "tradingDateFrom":"",
        "tradingDateTo":"",
        "underwriterId":[n,n,...],
    },
    "industry":{
        "hooversIndustryCode":["","",...],
        "primaryOnly":boolean,
        "nAICS":["","",...],
        "nAICSRange":[{from:"",to:""}... ],
        "uSSIC":["","",...],
        "uSSICRange":[{from:"",to:""}... ],
        "uKSIC":["","",...],
        "uKSICRange":[{from:"",to:""}... ]
    },
    "location":{
        "areacode":["","",...],
        "streetAddress":["","",...],
        "county":[
            {
                "countyId":n,
                "state":"",
                "countryId":n
            },
            ...
        ],
        "city":["","",...],
        "countryId":[n,n,...],
        "globalState":["","",...],
        "metropolitanId":[n,n,...],
        "regionId":[n,n,...],
        "usStateCanadaProvince":["","",...],
        "postalCode":["","",...],
        "usZipCodeRange":[{"from":n,"to":n},...],
        "zipAreaSearch":{
            "scale":"",
            "radius":n,
            "zipCode":""
        },
        "latLongSearch":{
            "scale":"",
            "radius":n,
            "latitude":n,
            "longitude":n
        },
        "allAny":"",
        "ukCounty":["","",...],
    },
    "specialtyCriteria":{
        "auditorId":[n,n,...],
        "companyKeyword":"",
        "duns":[n,n,...],
        "exchangeId":[n,n,...],
        "rankingId":[n,n,...],
        "ukRegistration":["","",...],
        "ukVat":["","",...],
        "yearFoundingFrom":n,
        "yearFoundingTo":n,
        "ultimateParentDuns":[n,n,...],
        "primaryUrl":["","",...],
        "companyName":"",
        "minorityOwned":boolean,
        "womenOwned":boolean,
        "squareFootageFrom":n,
        "squareFootRangeTo":n,
        "ethnicity":["","",...],
        "legalStatus":["","",...],
        "ownedOrRented":""
    },
    "searchNavigation":{
        "employeeSearchNavigation":{
            "employeeSearchNavigationValue":["","",...]
        },
        "ownershipTypeSearchNavigation":{
            "ownershipTypeSearchNavigationValue":["","",...]
        },
        "locationTypeSearchNavigation":{
            "locationTypeSearchNavigationValue":["","",...]
        },
        "salesSearchNavigation":{
            "salesSearchNavigationValue":["","",...]
        },
        "locationSearchNavigation":{
            "countryNavigation":[{
                "countryNavigationValue":"",
                "stateNavigation":[{
                    "stateNavigationValue":"",
                        "cityNavigation":[{
                            "cityNavigationValue":""
                        }]
                }]
            }]
        },
        "industrySearchNavigation":{
            "industrySearchNavigationValue":["","",...],
            "ussicSearchNavigationValue":["","",...],
            "naicsSearchNavigationValue":["","",...]
        }
    }
}
    

4.4 Output Parameters

Media type 'application/json; charset=UTF-8;'

Name Type Value(s)
companies: Object  
companies: { firstHit Number First Hit
companies: { lastHit Number Last Hit
companies: { hits Number Total Number of Hits in this Response
companies: { totalHits Number Aggregate Total Number of Hits. This is the total number of results the search returned.
companies: { hit: Object  
companies: { hit: { hitNumber Number Hit Number
companies: { hit: { companyResults: Object  
companies: { hit: { companyResults: { locationType: String location type of the company
companies: { hit: { companyResults: { address1: String Address of the company
companies: { hit: { companyResults: { city: String City
companies: { hit: { companyResults: { country: String Country
companies: { hit: { companyResults: { countryId: Number Country Id
companies: { hit: { companyResults: { stateOrProvince: String State or Province
companies: { hit: { companyResults: { postalCode: String Postal code
companies: { hit: { companyResults: { primaryUrl: String Primary Url of the company
companies: { hit: { companyResults: { parentDuns: Number Parent Duns Number
companies: { hit: { companyResults: { ultimateParentDuns: Number Ultimate Parent Duns
companies: { hit: { companyResults: { sales: Number Sales of the company
companies: { hit: { companyResults: { hqPhone: String Head Quarters Phone Number
companies: { hit: { companyResults: { doNotCallRegistry: Boolean Indicates whether company is listed on a UK Do Not Call registry
companies: { hit: { companyResults { dbas { dba: [ Array of Strings dbas
companies: { hit: { companyResults:: { historicalIndicator Boolean Indicates any boneyard companies
companies: { hit: { companyResults: { companyName: String Company Name
companies: { hit: { companyResults: { companyId: Number Company Id
companies: { hit: { companyResults: { duns: Number Duns Id of the comapany
navigators: { Object Navigation values for the companies
navigators:{ employeeNavigators: { Object Employee Navigation values for the companies
navigators:{ employeeNavigators: { employeeNavigator: [ List List of Employee navigation values
navigators:{ employeeNavigators: {employeeNavigator: [employeeNavigatorValue: String Employee Navigator value
navigators:{ employeeNavigators: {employeeNavigator: [employeeNavigatorDescription: String Employee Navigator Description
navigators:{ locationTypeNavigators: { Object Location Type Navigation values for the companies
navigators:{ locationTypeNavigators: {locationTypeNavigator: [ List of Location Type Navigators List of Location Type navigation values
navigators:{ locationTypeNavigators: {locationTypeNavigator: [locationTypeNavigatorValue: String Location Type Navigator value
navigators:{ locationTypeNavigators: {locationTypeNavigator: [locationTypeNavigatorDescription: String Location Type Navigator Description
navigators:{ ownershipTypeNavigators: { Object Ownership Type Navigation values for the companies
navigators:{ ownershipTypeNavigators: {ownershipTypeNavigator: [ List of Ownership Type Navigators List of Ownership Type navigation values
navigators:{ ownershipTypeNavigators: {ownershipTypeNavigator: [ownershipTypeNavigatorValue: String Ownership Type Navigator value
navigators:{ ownershipTypeNavigators: {ownershipTypeNavigator: [ownershipTypeNavigatorDescription: String Ownership Type Navigator Description
navigators:{ salesNavigators: { Object Sales Navigation values for the companies
navigators:{ salesNavigators {salesNavigator: [ List of Sales Navigators List of Sales navigation values
navigators:{ salesNavigators: {salesNavigator: [salesNavigatorValue: String Sales Navigator value
navigators:{ salesNavigators: {salesNavigator: [salesNavigatorDescription: String Sales Navigator Description
navigators:{ locationNavigators: { Object Location Navigation values for the companies
navigators:{ locationNavigators: {countryNavigators { Object Country Navigators
navigators:{ locationNavigators: {countryNavigators :{countryNavigator :[ List of Country Navigators Country Navigation values
navigators:{ locationNavigators: {countryNavigators :{countryNavigator :[countryNavigatorValue : String Country Navigation value
navigators:{ locationNavigators: {countryNavigators :{countryNavigator :[countryNavigatorDescription : String Country Navigation value
navigators:{ locationNavigators: {countryNavigators :{countryNavigator :[stateProvinceNavigator : { Object State or Province Navigator
navigators:{ locationNavigators: {countryNavigators :{countryNavigator :[ stateProvinceNavigator: {stateProvinceNavigatorValue : String State or Province Navigator value
navigators:{ locationNavigators: {countryNavigators :{countryNavigator :[ stateProvinceNavigator: {stateProvinceNavigatorDescription : String State or Province Navigator description
navigators:{ locationNavigators: {countryNavigators :{countryNavigator :[ stateProvinceNavigator: {cityNavigators :{ Object City Navigator
navigators:{ locationNavigators: {countryNavigators :{countryNavigator :[ stateProvinceNavigator: {cityNavigators {:cityNavigator :[ List list of City Navigators
navigators:{ locationNavigators: {countryNavigators :{countryNavigator :[ stateProvinceNavigator: {cityNavigators {:cityNavigator :[ cityNavigatorValue : String City Navigator value
navigators:{ locationNavigators: {countryNavigators :{countryNavigator :[ stateProvinceNavigator: {cityNavigators {:cityNavigator :[ cityNavigatorDescription : String City Navigator Description
navigators:{ industryNavigators: { Object Industry Navigation values for the companies
navigators:{ industryNavigators: {industrySearchNavigationValue: [ Array of Strings List of Industry navigation values
navigators:{ industryNavigators: {naicsSearchNavigationValue: [ Array of Strings List of NAICS search navigation values
navigators:{ industryNavigators: {ussicSearchNavigationValue: [ Array of Strings List of USSIC search navigation values

5 Find Company By Keyword - /search/company/{keyword}

5.1 Overview

Returns search result of companies based on varying different criteria

5.2 Input URI

This is a "POST" only call not requiring any query or path parameters other than listed.

HTTP Methods Accepted Context Path Headers Sample URL
POST HooversAPI-40/rest "username" and "password" HTTP headers are mandatory http://hapi.hoovers.com/HooversAPI-40/rest/search/company/Hoovers?hit_offset=0&max_records=20&sort_direction=ascending&order_by=company_name

5.3 Input Parameters

5.3.1 Path Parameters

All path parameters are named in lowercase, with an underscore separator for multiple words.

Path Parameter Sample Type Value(s)
search/company/{keyword} search/company/ibm String dell, ibm
search/company/{DunsFrom} search/company/1005003 Long
search/company/{DunsTo} search/company/1005006

5.3.2 Query Parameters

All query parameters are named in lowercase, with an underscore separator for multiple words.

Query Parameter Sample Type Value(s)
hit_offset={hit_offset} hit_offset=0 Number 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 zero-based.
max_records={max_records} max_records=20 Number Between 1-200. Default = 20
search_by={search_by} search_by=company_name String
  • company_name
  • stock_symbol
return_search_navigation={return_search_navigation} return_search_navigation=false Boolean Default return search navigation is false. Other values for this search include:
  • false
  • true
sort_direction={sort_direction} sort_direction=ascending String Default sort direction is ascending. Other values for this search include:
  • ascending
  • descending
order_by={order_by} order_by=company_name String Default order by is relevance. Other values for this search include:
  • company_name
  • company_type
  • country_name
  • city_name
  • state_name
  • phone_number
  • fax_number
  • sales_growth_12_mon
  • total_assets
  • sales_us
  • employees_total
  • employees_here
  • fiscal_year_end_month
  • market_cap
  • net_income_growth_12_mon
  • employee_growth_12_mon
  • roe
  • roa
  • earnings_comparison
  • book_value_comparison
  • net_income
  • person_first_name
  • person_last_name
  • person_title

5.3.3 JSON Entity

Media type 'application/json'

Name Type Value(s)
searchNavigation: Object Top level JSON object used to wrap Search Navigation input data.
searchNavigation: { employeeSearchNavigation: Object Top level JSON object used to wrap Employee Search Navigation input data.
searchNavigation { employeeSearchNavigation: { employeeSearchNavigationValue: Array of Strings Value from GetAdvancedSearchLookups
searchNavigation: { ownershipTypeSearchNavigation: Object Top level JSON object used to wrap OwnerShip type Search Navigation input data.
searchNavigation { ownershipTypeSearchNavigation: { ownershipTypeSearchNavigationValue: Array of Strings Value from GetAdvancedSearchLookups
searchNavigation: { locationTypeSearchNavigation: Object Top level JSON object used to wrap Location type Search Navigation input data.
searchNavigation { locationTypeSearchNavigation: { locationTypeSearchNavigationValue: Array of Strings Value from GetAdvancedSearchLookups
searchNavigation: { salesSearchNavigation: Object Top level JSON object used to wrap sales Search Navigation input data.
searchNavigation { salesSearchNavigation: { salesSearchNavigationValue: Array of Strings Value from GetAdvancedSearchLookups
searchNavigation: { locationSearchNavigation: Object Top level JSON object used to wrap Location Search Navigation input data.
searchNavigation { locationSearchNavigation: { countryNavigation: Object Top level JSON object used to wrap Country Navigation input data.
searchNavigation { locationSearchNavigation { countryNavigation: { countryNavigationValue: String Value from GetAdvancedSearchLookups
searchNavigation { locationSearchNavigation { countryNavigation: { stateNavigation: Object Top level JSON object used to wrap State Navigation input data.
searchNavigation { locationSearchNavigation { countryNavigation { stateNavigation: { stateNavigationValue: Array of Strings Value from GetAdvancedSearchLookups
searchNavigation { locationSearchNavigation { countryNavigation { stateNavigation: { cityNavigation: Object Top level JSON object used to wrap City Navigation input data.
searchNavigation { locationSearchNavigation { countryNavigation { stateNavigation { cityNavigation: { cityNavigationValue: Array of Strings Value from GetAdvancedSearchLookups
searchNavigation: { industrySearchNavigation: Object Top level JSON object used to wrap sales Industry Navigation input data.
searchNavigation { industrySearchNavigation: { industrySearchNavigationValue: Array of Strings Value from GetAdvancedSearchLookups
searchNavigation { industrySearchNavigation: { ussicSearchNavigationValue: Array of Strings Value from GetAdvancedSearchLookups
searchNavigation { industrySearchNavigation: { naicsSearchNavigationValue: Array of Strings Value from GetAdvancedSearchLookups
nonMarketableCompanyFilterOptions Object Top level JSON object used to wrap non marketable options.
nonMarketableCompanyFilterOptions { includeUndeliverableAddress: Boolean Option to show companies that are non-marketable due to an undeliverable address
nonMarketableCompanyFilterOptions { includeOutOfBusiness: Boolean Option to show companies that are non-marketable due to being out of business
nonMarketableCompanyFilterOptions { includeIncompleteData: Boolean Option to show companies that are non-marketable due to incomplete data

5.3.4 Sample JSON for POST - contains ALL fields with invalid values, only use what you need

    
{
    "searchNavigation":{
        "employeeSearchNavigation":{
            "employeeSearchNavigationValue":["","",...]
        }
        "ownershipTypeSearchNavigation":{
            "ownershipTypeSearchNavigationValue":["","",...]
        }
        "locationTypeSearchNavigation":{
            "locationTypeSearchNavigationValue":["","",...]
        }
        "salesSearchNavigation":{
            "salesSearchNavigationValue":["","",...]
        }
        "locationSearchNavigation":{
            "countryNavigation":[{
                "countryNavigationValue":"",
                "stateNavigation":[{
                    "stateNavigationValue":"",
                        "cityNavigation":[{
                            "cityNavigationValue":""
                        }]
                }]
            }]
        }
        "industrySearchNavigation":{
            "industrySearchNavigationValue":["","",...],
            "ussicSearchNavigationValue":["","",...],
            "naicsSearchNavigationValue":["","",...]
        }
    },
    "nonMarketableCompanyFilterOptions":{
      "includeUndeliverableAddress":"true",
      "includeOutOfBusiness":"true",
      "includeIncompleteData":"true"
    }
}
    

5.4 Output Parameters

Media type 'application/json; charset=UTF-8;'

Name Type Value(s)
resultSet: Object  
resultSet: { firstHit Number First Hit
resultSet: { lastHit Number Last Hit
resultSet: { hits Number Total Number of Hits in this Response
resultSet: { totalHits Number Aggregate Total Number of Hits. This is the total number of results the search returned.
resultSet: { hit: Object  
resultSet: { hit: { hitNumber Number Hit Number
resultSet: { hit: { companyResults: Object  
resultSet: { hit: { companyResults: { locationType: String location type of the company
resultSet: { hit: { companyResults: { address1: String Address of the company
resultSet: { hit: { companyResults: { city: String City
resultSet: { hit: { companyResults: { country: String Country
resultSet: { hit: { companyResults: { countryId: Number Country Id
resultSet: { hit: { companyResults: { stateOrProvince: String State or Province
resultSet: { hit: { companyResults: { primaryUrl: String Primary Url of the company
resultSet: { hit: { companyResults: { parentDuns: Number Parent Duns Number
resultSet: { hit: { companyResults: { ultimateParentDuns: Number Ultimate Parent Duns
resultSet: { hit: { companyResults: { nonMarketableCompany Object This object contains child tags representing the reasons for which this company is taged as non-marketable.
resultSet: { hit: { companyResults: { nonMarketableCompany:{ reasons String value The possible reasons are
  • Out of business
  • Invalid address
  • Key data missing/needing revision
  • Donot market to
resultSet: { hit: { companyResults: { sales: Number Sales of the company
resultSet: { hit: { companyResults: { hqPhone: String Head Quarters Phone Number
resultSet: { hit: { companyResults: { doNotCallRegistry: Boolean Indicates whether company is listed on a UK Do Not Call registry
resultSet: { hit: { companyResults { dbas { dba: [ Array of Strings dbas
resultSet: { hit: { companyResults: { historicalIndicator: Boolean Indicates any boneyard companies
resultSet: { hit: { companyResults: { exchanges: [ Array of Stock ticker information Indicates any stock exchange information
resultSet: { hit: { companyResults: { exchanges: [ { tickerSymbol: String Indicates the stock ticker symbol
resultSet: { hit: { companyResults: { exchanges: [ { exchangeName: String Indicates the stock ticker exchange name
resultSet: { hit: { companyResults: { companyName: String Company Name
resultSet: { hit: { companyResults: { companyId: Number Company Id
resultSet: { hit: { companyResults: { duns: Number Duns Id of the comapany
navigators: { Object Navigation values for the companies
navigators:{ employeeNavigators: { Object Employee Navigation values for the companies
navigators:{ employeeNavigators: { employeeNavigator: [ List List of Employee navigation values
navigators:{ employeeNavigators: {employeeNavigator: [employeeNavigatorValue: String Employee Navigator value
navigators:{ employeeNavigators: {employeeNavigator: [employeeNavigatorDescription: String Employee Navigator Description
navigators:{ locationTypeNavigators: { Object Location Type Navigation values for the companies
navigators:{ locationTypeNavigators: {locationTypeNavigator: [ List of Location Type Navigators List of Location Type navigation values
navigators:{ locationTypeNavigators: {locationTypeNavigator: [locationTypeNavigatorValue: String Location Type Navigator value
navigators:{ locationTypeNavigators: {locationTypeNavigator: [locationTypeNavigatorDescription: String Location Type Navigator Description
navigators:{ ownershipTypeNavigators: { Object Ownership Type Navigation values for the companies
navigators:{ ownershipTypeNavigators: {ownershipTypeNavigator: [ List of Ownership Type Navigators List of Ownership Type navigation values
navigators:{ ownershipTypeNavigators: {ownershipTypeNavigator: [ownershipTypeNavigatorValue: String Ownership Type Navigator value
navigators:{ ownershipTypeNavigators: {ownershipTypeNavigator: [ownershipTypeNavigatorDescription: String Ownership Type Navigator Description
navigators:{ salesNavigators: { Object Sales Navigation values for the companies
navigators:{ salesNavigators {salesNavigator: [ List of Sales Navigators List of Sales navigation values
navigators:{ salesNavigators: {salesNavigator: [salesNavigatorValue: String Sales Navigator value
navigators:{ salesNavigators: {salesNavigator: [salesNavigatorDescription: String Sales Navigator Description
navigators:{ locationNavigators: { Object Location Navigation values for the companies
navigators:{ locationNavigators: {countryNavigators { Object Country Navigators
navigators:{ locationNavigators: {countryNavigators :{countryNavigator :[ List of Country Navigators Country Navigation values
navigators:{ locationNavigators: {countryNavigators :{countryNavigator :[countryNavigatorValue : String Country Navigation value
navigators:{ locationNavigators: {countryNavigators :{countryNavigator :[countryNavigatorDescription : String Country Navigation value
navigators:{ locationNavigators: {countryNavigators :{countryNavigator :[stateProvinceNavigator : { Object State or Province Navigator
navigators:{ locationNavigators: {countryNavigators :{countryNavigator :[ stateProvinceNavigator: {stateProvinceNavigatorValue : String State or Province Navigator value
navigators:{ locationNavigators: {countryNavigators :{countryNavigator :[ stateProvinceNavigator: {stateProvinceNavigatorDescription : String State or Province Navigator description
navigators:{ locationNavigators: {countryNavigators :{countryNavigator :[ stateProvinceNavigator: {cityNavigators :{ Object City Navigator
navigators:{ locationNavigators: {countryNavigators :{countryNavigator :[ stateProvinceNavigator: {cityNavigators {:cityNavigator :[ List list of City Navigators
navigators:{ locationNavigators: {countryNavigators :{countryNavigator :[ stateProvinceNavigator: {cityNavigators {:cityNavigator :[ cityNavigatorValue : String City Navigator value
navigators:{ locationNavigators: {countryNavigators :{countryNavigator :[ stateProvinceNavigator: {cityNavigators {:cityNavigator :[ cityNavigatorDescription : String City Navigator Description
navigators:{ industryNavigators: { Object Industry Navigation values for the companies
navigators:{ industryNavigators: {industrySearchNavigationValue: [ Array of Strings List of Industry navigation values
navigators:{ industryNavigators: {naicsSearchNavigationValue: [ Array of Strings List of NAICS search navigation values
navigators:{ industryNavigators: {ussicSearchNavigationValue: [ Array of Strings List of USSIC search navigation values

6 Find Company By Keyword Basic - Autocomplete - /search/company/basic/{keyword}

6.1 Overview

Returns limited search results of companies based on keyword. If you are implementing an autocomplete feature, we suggest using this call as it will be the quickest due to limited backend processing and a smaller payload on the response.

6.2 Input URI

This is a "GET" only call not requiring any query or path parameters other than listed.

HTTP Methods Accepted Context Path Headers Sample URL
GET HooversAPI-%version%/rest "username" and "password" HTTP headers are mandatory http://hapi.hoovers.com/HooversAPI-40/rest/search/company/basic/Hoovers?limit=5

6.3 Input Parameters

6.3.1 Path Parameters

All path parameters are named in lowercase, with an underscore separator for multiple words.

Path Parameter Sample Type Value(s)
search/company/basic/{keyword} search/company/basic/Hoovers

6.3.2 Query Parameters

All query parameters are named in lowercase, with an underscore separator for multiple words.

Query Parameter Sample Type Value(s)
limit={limit} limit=0 Number Greater than or equal to 0 but less than or equal to 10. Default = 5.

6.4 Output Parameters

Media type 'application/json; charset=UTF-8;'

Name Type Value(s)
companies: Array  
companies: { link: Object Contains a relative URI to the specific company and the URI's relationship to the company
companies: { link: { rel: String The URI's type, in this case, a link to the company's basic profile
companies: { link: { http: String URI of the basic view of the company
companies: { duns: Number DUNS of the company
companies: { companyId: Number Hoover's Company ID of the company
companies: { companyName: String Company Name
companies: { revenue: Number Annual Revenue in Millions USD
companies: { city: String City
companies: { state: String State

7 Get Family Tree - /company/familytree/{unique_id}

7.1 Overview

Returns ultimate parent of the given DUNS or Hoover's Company ID and all of the children/descendants of that ultimate parent.

7.2 Input URI

This is a "GET" only call not requiring any query or path parameters other than listed.

HTTP Methods Accepted Context Path Headers Sample URL
GET HooversAPI-%version%/rest "username" and "password" HTTP headers are mandatory http://hapi.hoovers.com/HooversAPI-40/rest/company/familytree/41885000000000

7.3 Input Parameters

7.3.1 Path Parameters

All path parameters are named in lowercase, with an underscore separator for multiple words.

Path Parameter Sample Type Value(s)
company/familytree/{unique_id} company/familytree/41885000000000

7.3.2 Query Parameters

No query parameters are defined.

7.3.3 JSON Entity

Media type 'application/json'

Name Type Value(s)
depthLimit: Number Number of layers or levels of the family tree structure to return (0-10)
city: Array of Strings City
state: Array of Strings State
country: Array of Strings Country
locationType: Array of Strings Location Type ("HEADQUARTERS","BRANCH","SINGLE_LOCATION")
includeUndeliverableAddress: Boolean If true, includes unmarketable company records which have an undeliverable address.
includeOutOfBusiness: Boolean If true, includes unmarketable company records which are out of business.
includeIncompleteData: Boolean If true, includes unmarketable company records which have incomplete data.
includeDoNotMarketTo: Boolean If true, includes unmarketable company records which have an undeliverable address.

7.3.4 Sample JSON for POST - contains ALL fields with invalid values, only use what you need

    
{
    "depthLimit":n,
    "city":["","",...],
    "state":["","",...],
    "country":["","",...],
    "locationType":["","",...],
    "includeUndeliverableAddress":boolean,
    "includeOutOfBusiness":boolean,
    "includeIncompleteData":boolean,
    "includeDoNotMarketTo":boolean
}
    

7.4 Output Parameters

Media type 'application/json; charset=UTF-8;'

Name Type Value(s)
name: String Company Name
companyId: Number Hoover's Company ID of the company
duns: Number DUNS of the company
parentDuns: Number DUNS of the parent company
ultimateParentDuns: Number DUNS of the ultimate parent company
revenue: Number Annual Revenue in Millions USD
currencyType: String Currency Type of Revenue
locationType: String Headquarters, Branch, etc.
city: String City
state: String State
country: String Country
additionalData Object Top level JSON object used to wrap additional data
additionalData { undeliverableAddress: Boolean Indicates whether company has an undeliverable address
additionalData { outOfBusiness: Boolean Indicates whether company is out of business
additionalData { incompleteData: Boolean Indicates whether company has incomplete data
additionalData { doNotMarketTo: Boolean Indicates whether company is delisted as do not market to
totalChildren: Number Aggregate Total Number of Children for this unique ID
children Object Top level JSON object used to wrap children
children { child: Array Array of family tree child companies
children: child { number: Number Family tree child identifier
children: child { name: String Child company name
children: child { companyId: Number Hoover's Company ID of the company
children: child { duns: Number DUNS of the company
children: child { parentDuns: Number DUNS of the parent company
children: child { ultimateParentDuns: Number DUNS of the ultimate parent company
children: child { revenue: Number Annual Revenue in Millions USD
children: child { currencyType: String Currency Type of Revenue
children: child { locationType: String Headquarters, Branch, etc.
children: child { city: String City
children: child { state: String State
children: child { country: String Country
children: child { additionalData: Object JSON object used to wrap additional data for child company
children: child: additionalData { undeliverableAddress: Boolean Indicates whether company has an undeliverable address
children: child: additionalData { outOfBusiness: Boolean Indicates whether company is out of business
children: child: additionalData { incompleteData: Boolean Indicates whether company has incomplete data
children: child: additionalData { doNotMarketTo: Boolean Indicates whether company is delisted as do not market to
children: child { children: Object JSON object for any child companies (repeat "children" as needed)

8 Get Company Financial Summary - /company/{unique_id}/financial/summary

8.1 Overview

Returns financial summary for the company associated with the given DUNS or Hoover's Company ID.

8.2 Input URI

This is a "GET" only call not requiring any query or path parameters other than listed.

HTTP Methods Accepted Context Path Headers Sample URL
GET HooversAPI-%version%/rest "username" and "password" HTTP headers are mandatory http://hapi.hoovers.com/HooversAPI-40/rest/company/41885000000000/financial/summary

8.3 Input Parameters

8.3.1 Path Parameters

All path parameters are named in lowercase, with an underscore separator for multiple words.

Path Parameter Sample Type Value(s)
company/{unique_id}/financial/summary company/41885000000000/financial/summary

8.3.2 Query Parameters

No query parameters are defined.

8.4 Output Parameters

Media type 'application/json; charset=UTF-8;'

Name Type Value(s)
basicFinancialInformation: Object JSON object used to wrap the company's basic financial information
basicFinancialInformation: { companyType: String Type of Company
basicFinancialInformation: { location: String Location of Company
basicFinancialInformation: { exchanges Object Top level JSON object used to wrap exchanges
basicFinancialInformation: { exchanges { exchange: Array Array of child exchanges
basicFinancialInformation: { exchanges: exchange { exchangeName: String Name for the exchange
basicFinancialInformation: { exchanges: exchange { tickerSymbol: String Ticker symbol for the exchange
basicFinancialInformation: { fiscalYearEnd: String Last Month for the end of the Fiscal Year
basicFinancialInformation: { financialFilingsUrl: String Financial Filings URL
basicFinancialInformation: { latestYearSales: Object Top level JSON object used to wrap latest year sales data
basicFinancialInformation: { latestYearSales { amount: String Latest year sales amount
basicFinancialInformation: { latestYearSales { year: String Latest year sales year
basicFinancialInformation:oneYearSalesGrowthPct: String One Year Sales Growth Percentage
basicFinancialInformation:latestYearNetIncome: Object Top level JSON object used to wrap latest year net income data
basicFinancialInformation: { latestYearNetIncome { amount: String Latest year net income amount
basicFinancialInformation: { latestYearNetIncome { year: String Latest year net income year
basicFinancialInformation:oneYearNetIncomeGrowthPct: String One Year Net Income Growth Percentage
basicFinancialInformation:auditor: String Auditor
comparisonToIndustryAndMarket: Object JSON object used to wrap the company, industry and market financial information
comparisonToIndustryAndMarket:{ company: Object JSON object used to wrap the company financial information
comparisonToIndustryAndMarket:{ company:{ priceSalesRatio: String company's priceSalesRatio
comparisonToIndustryAndMarket:{ company:{ priceEarningRatio: String company's priceEarningRatio
comparisonToIndustryAndMarket:{ company:{ priceBookRatio: String company's priceBookRatio
comparisonToIndustryAndMarket:{ company:{ priceCashFlowRatio: String company's priceCashFlowRatio
comparisonToIndustryAndMarket:{ industry: Object JSON object used to wrap the industry financial information
comparisonToIndustryAndMarket:{ industry:{ priceSalesRatio: String industry's priceSalesRatio
comparisonToIndustryAndMarket:{ industry:{ priceEarningRatio: String industry's priceEarningRatio
comparisonToIndustryAndMarket:{ industry:{ priceBookRatio: String industry's priceBookRatio
comparisonToIndustryAndMarket:{ industry:{ priceCashFlowRatio: String industry's priceCashFlowRatio
comparisonToIndustryAndMarket:{ market: Object JSON object used to wrap the market financial information
comparisonToIndustryAndMarket:{ market:{ priceSalesRatio: String market's priceSalesRatio
comparisonToIndustryAndMarket:{ market:{ priceEarningRatio: String market's priceEarningRatio
comparisonToIndustryAndMarket:{ market:{ priceBookRatio: String market's priceBookRatio
comparisonToIndustryAndMarket:{ market:{ priceCashFlowRatio: String market's priceCashFlowRatio
topCompetitors: Object JSON object used to wrap the top 3 competitors information
topCompetitors:{ competitor1: Object JSON object used to wrap the first competitor information
topCompetitors:{ competitor1:{ companyName: String company name of competitor 1
topCompetitors:{ competitor1:{ annualSales: String annualSales of competitor 1
topCompetitors:{ competitor1:{ employees: String employees count of competitor 1
topCompetitors:{ competitor1:{ marketCap: String marketCap of competitor 1
topCompetitors:{ competitor2: Object JSON object used to wrap the second competitor information
topCompetitors:{ competitor2:{ companyName: String company name of competitor 2
topCompetitors:{ competitor2:{ annualSales: String annualSales of competitor 2
topCompetitors:{ competitor2:{ employees: String employees count of competitor 2
topCompetitors:{ competitor2:{ marketCap: String marketCap of competitor 2
topCompetitors:{ competitor3: Object JSON object used to wrap the third competitor information
topCompetitors:{ competitor3:{ companyName: String company name of competitor 3
topCompetitors:{ competitor3:{ annualSales: String annualSales of competitor 3
topCompetitors:{ competitor3:{ employees: String employees count of competitor 3
topCompetitors:{ competitor3:{ marketCap: String marketCap of competitor 3
annualBalanceSheets: Object JSON object used to wrap the annual balance sheet information
annualBalanceSheets:{ latestYear: Object JSON object used to wrap the latest year balance sheet information
annualBalanceSheets:{ latestYear:{ year: String latest year
annualBalanceSheets:{ latestYear:{ assets: Object JSON object used to wrap the latest year assets information
annualBalanceSheets:{ latestYear:{ assets:{ currentAssets: Object JSON object used to wrap the latest year current assets information
annualBalanceSheets:{ latestYear:{ assets:{ currentAssets:{ cash: String cash
annualBalanceSheets:{ latestYear:{ assets:{ currentAssets:{ netReceivables: String net receivables
annualBalanceSheets:{ latestYear:{ assets:{ currentAssets:{ inventories: String inventories
annualBalanceSheets:{ latestYear:{ assets:{ currentAssets:{ otherIncomeAssets: String other income assets
annualBalanceSheets:{ latestYear:{ assets:{ assetSummary: Object JSON object used to wrap the latest year asset summary information
annualBalanceSheets:{ latestYear:{ assets:{ assetSummary:{ totalCurrentAssets: String total current assets
annualBalanceSheets:{ latestYear:{ assets:{ assetSummary:{ netFixedAssets: String net fixed assets
annualBalanceSheets:{ latestYear:{ assets:{ assetSummary:{ otherNonCurrentAssets: String other non current assets
annualBalanceSheets:{ latestYear:{ assets:{ assetSummary:{ totalAssets: String total assets
annualBalanceSheets:{ latestYear:{ liabilities: Object JSON object used to wrap the latest year liabilities information
annualBalanceSheets:{ latestYear:{ liabilities:{ currentLiabilities: Object JSON object used to wrap the latest year current liabilities information
annualBalanceSheets:{ latestYear:{ liabilities:{ currentLiabilities:{ accountsPayable: String accounts payable
annualBalanceSheets:{ latestYear:{ liabilities:{ currentLiabilities:{ shortTermDebt: String short term debt
annualBalanceSheets:{ latestYear:{ liabilities:{ currentLiabilities:{ otherCurrentLiabilities: String other current liabilities
annualBalanceSheets:{ latestYear:{ liabilities:{ liabilitySummary: Object JSON object used to wrap the latest year liability summary information
annualBalanceSheets:{ latestYear:{ liabilities:{ liabilitySummary:{ totalCurrentLiabilities: String cash
annualBalanceSheets:{ latestYear:{ liabilities:{ liabilitySummary:{ longTermDebt: String long term debt
annualBalanceSheets:{ latestYear:{ liabilities:{ liabilitySummary:{ otherNonCurrentLiabilities: String other non current liabilities
annualBalanceSheets:{ latestYear:{ liabilities:{ liabilitySummary:{ totalLiabilities: String total liabilities
annualBalanceSheets:{ latestYear:{ shareholdersEquity: Object JSON object used to wrap the latest year share holders equity information
annualBalanceSheets:{ latestYear:{ shareholdersEquity:{ equity: Object JSON object used to wrap the latest year equity information
annualBalanceSheets:{ latestYear:{ shareholdersEquity:{ equity:{ preferredStockEquity: String preferred stock equity
annualBalanceSheets:{ latestYear:{ shareholdersEquity:{ equity:{ commonStockEquity: String common stock equity
annualBalanceSheets:{ latestYear:{ shareholdersEquity:{ equitySummary: Object JSON object used to wrap the latest year equity summary information
annualBalanceSheets:{ latestYear:{ shareholdersEquity:{ equitySummary:{ totalEquity: String total equity
annualBalanceSheets:{ latestYear:{ shareholdersEquity:{ equitySummary:{ sharesOutstanding: String shares outstanding
annualBalanceSheets:{ previousYears: Object JSON objects used to wrap the previous years balance sheet information
annualBalanceSheets:{ previousYears:{ year: String latest year
annualBalanceSheets:{ previousYears:{ assets: Object JSON object used to wrap the previous year assets information
annualBalanceSheets:{ previousYears:{ assets:{ currentAssets: Object JSON object used to wrap the previous year current assets information
annualBalanceSheets:{ previousYears:{ assets:{ currentAssets:{ cash: String cash
annualBalanceSheets:{ previousYears:{ assets:{ currentAssets:{ netReceivables: String net receivables
annualBalanceSheets:{ previousYears:{ assets:{ currentAssets:{ inventories: String inventories
annualBalanceSheets:{ previousYears:{ assets:{ currentAssets:{ otherIncomeAssets: String other income assets
annualBalanceSheets:{ previousYears:{ assets:{ assetSummary: Object JSON object used to wrap the previous year asset summary information
annualBalanceSheets:{ previousYears:{ assets:{ assetSummary:{ totalCurrentAssets: String total current assets
annualBalanceSheets:{ previousYears:{ assets:{ assetSummary:{ netFixedAssets: String net fixed assets
annualBalanceSheets:{ previousYears:{ assets:{ assetSummary:{ otherNonCurrentAssets: String other non current assets
annualBalanceSheets:{ previousYears:{ assets:{ assetSummary:{ totalAssets: String total assets
annualBalanceSheets:{ previousYears:{ liabilities: Object JSON object used to wrap the previous year liabilities information
annualBalanceSheets:{ previousYears:{ liabilities:{ currentLiabilities: Object JSON object used to wrap the previous year current liabilities information
annualBalanceSheets:{ previousYears:{ liabilities:{ currentLiabilities:{ accountsPayable: String accounts payable
annualBalanceSheets:{ previousYears:{ liabilities:{ currentLiabilities:{ shortTermDebt: String short term debt
annualBalanceSheets:{ previousYears:{ liabilities:{ currentLiabilities:{ otherCurrentLiabilities: String other current liabilities
annualBalanceSheets:{ previousYears:{ liabilities:{ liabilitySummary: Object JSON object used to wrap the previous year liability summary information
annualBalanceSheets:{ previousYears:{ liabilities:{ liabilitySummary:{ totalCurrentLiabilities: String cash
annualBalanceSheets:{ previousYears:{ liabilities:{ liabilitySummary:{ longTermDebt: String long term debt
annualBalanceSheets:{ previousYears:{ liabilities:{ liabilitySummary:{ otherNonCurrentLiabilities: String other non current liabilities
annualBalanceSheets:{ previousYears:{ liabilities:{ liabilitySummary:{ totalLiabilities: String total liabilities
annualBalanceSheets:{ previousYears:{ shareholdersEquity: Object JSON object used to wrap the previous year share holders equity information
annualBalanceSheets:{ previousYears:{ shareholdersEquity:{ equity: Object JSON object used to wrap the previous year equity information
annualBalanceSheets:{ previousYears:{ shareholdersEquity:{ equity:{ preferredStockEquity: String preferred stock equity
annualBalanceSheets:{ previousYears:{ shareholdersEquity:{ equity:{ commonStockEquity: String common stock equity
annualBalanceSheets:{ previousYears:{ shareholdersEquity:{ equitySummary: Object JSON object used to wrap the previous year equity summary information
annualBalanceSheets:{ previousYears:{ shareholdersEquity:{ equitySummary:{ totalEquity: String total equity
annualBalanceSheets:{ previousYears:{ shareholdersEquity:{ equitySummary:{ sharesOutstanding: String shares outstanding
quarterlyBalanceSheets: Object JSON object used to wrap the quarterly balance sheet information
quarterlyBalanceSheets:{ latestQuarter: Object JSON object used to wrap the latest quarter balance sheet information
quarterlyBalanceSheets:{ latestQuarter:{ quarterMonth: String last month of the quarter
quarterlyBalanceSheets:{ latestQuarter:{ quarterYear: String year of the quarter
quarterlyBalanceSheets:{ latestQuarter:{ assets: Object JSON object used to wrap the latest quarter assets information
quarterlyBalanceSheets:{ latestQuarter:{ assets:{ currentAssets: Object JSON object used to wrap the latest quarter current assets information
quarterlyBalanceSheets:{ latestQuarter:{ assets:{ currentAssets:{ cash: String cash
quarterlyBalanceSheets:{ latestQuarter:{ assets:{ currentAssets:{ netReceivables: String net receivables
quarterlyBalanceSheets:{ latestQuarter:{ assets:{ currentAssets:{ inventories: String inventories
quarterlyBalanceSheets:{ latestQuarter:{ assets:{ currentAssets:{ otherIncomeAssets: String other income assets
quarterlyBalanceSheets:{ latestQuarter:{ assets:{ assetSummary: Object JSON object used to wrap the latest quarter asset summary information
quarterlyBalanceSheets:{ latestQuarter:{ assets:{ assetSummary:{ totalCurrentAssets: String total current assets
quarterlyBalanceSheets:{ latestQuarter:{ assets:{ assetSummary:{ netFixedAssets: String net fixed assets
annualBalanceSheets:{ latestQuarter:{ assets:{ assetSummary:{ otherNonCurrentAssets: String other non current assets
quarterlyBalanceSheets:{ latestQuarter:{ assets:{ assetSummary:{ totalAssets: String total assets
quarterlyBalanceSheets:{ latestQuarter:{ liabilities: Object JSON object used to wrap the latest quarter liabilities information
quarterlyBalanceSheets:{ latestQuarter:{ liabilities:{ currentLiabilities: Object JSON object used to wrap the latest quarter current liabilities information
quarterlyBalanceSheets:{ latestQuarter:{ liabilities:{ currentLiabilities:{ accountsPayable: String accounts payable
quarterlyBalanceSheets:{ latestQuarter:{ liabilities:{ currentLiabilities:{ shortTermDebt: String short term debt
quarterlyBalanceSheets:{ latestQuarter:{ liabilities:{ currentLiabilities:{ otherCurrentLiabilities: String other current liabilities
quarterlyBalanceSheets:{ latestQuarter:{ liabilities:{ liabilitySummary: Object JSON object used to wrap the latest quarter liability summary information
quarterlyBalanceSheets:{ latestYear:{ liabilities:{ liabilitySummary:{ totalCurrentLiabilities: String cash
quarterlyBalanceSheets:{ latestQuarter:{ liabilities:{ liabilitySummary:{ longTermDebt: String long term debt
quarterlyBalanceSheets:{ latestQuarter:{ liabilities:{ liabilitySummary:{ otherNonCurrentLiabilities: String other non current liabilities
quarterlyBalanceSheets:{ latestQuarter:{ liabilities:{ liabilitySummary:{ totalLiabilities: String total liabilities
quarterlyBalanceSheets:{ latestQuarter:{ shareholdersEquity: Object JSON object used to wrap the latest quarter share holders equity information
quarterlyBalanceSheets:{ latestQuarter:{ shareholdersEquity:{ equity: Object JSON object used to wrap the latest quarter equity information
quarterlyBalanceSheets:{ latestQuarter:{ shareholdersEquity:{ equity:{ preferredStockEquity: String preferred stock equity
quarterlyBalanceSheets:{ latestQuarter:{ shareholdersEquity:{ equity:{ commonStockEquity: String common stock equity
quarterlyBalanceSheets:{ latestQuarter:{ shareholdersEquity:{ equitySummary: Object JSON object used to wrap the latest quarter equity summary information
quarterlyBalanceSheets:{ latestQuarter:{ shareholdersEquity:{ equitySummary:{ totalEquity: String total equity
quarterlyBalanceSheets:{ latestQuarter:{ shareholdersEquity:{ equitySummary:{ sharesOutstanding: String shares outstanding
quarterlyBalanceSheets:{ previousQuarters: Object JSON objects used to wrap the previous quarters balance sheet information
quarterlyBalanceSheets:{ previousQuarters:{ quarterMonth: String last month of the previous quarter
quarterlyBalanceSheets:{ previousQuarters:{ quarterYear: String latest year
quarterlyBalanceSheets:{ previousQuarters:{ assets: Object JSON object used to wrap the previous quarter assets information
quarterlyBalanceSheets:{ previousQuarters:{ assets:{ currentAssets: Object JSON object used to wrap the previous quarter current assets information
quarterlyBalanceSheets:{ previousQuarters:{ assets:{ currentAssets:{ cash: String cash
quarterlyBalanceSheets:{ previousQuarters:{ assets:{ currentAssets:{ netReceivables: String net receivables
quarterlyBalanceSheets:{ previousQuarters:{ assets:{ currentAssets:{ inventories: String inventories
quarterlyBalanceSheets:{ previousQuarters:{ assets:{ currentAssets:{ otherIncomeAssets: String other income assets
quarterlyBalanceSheets:{ previousQuarters:{ assets:{ assetSummary: Object JSON object used to wrap the previous quarter asset summary information
quarterlyBalanceSheets:{ previousQuarters:{ assets:{ assetSummary:{ totalCurrentAssets: String total current assets
quarterlyBalanceSheets:{ previousQuarters:{ assets:{ assetSummary:{ netFixedAssets: String net fixed assets
quarterlyBalanceSheets:{ previousQuarters:{ assets:{ assetSummary:{ otherNonCurrentAssets: String other non current assets
quarterlyBalanceSheets:{ previousQuarters:{ assets:{ assetSummary:{ totalAssets: String total assets
quarterlyBalanceSheets:{ previousQuarters:{ liabilities: Object JSON object used to wrap the previous quarter liabilities information
quarterlyBalanceSheets:{ previousQuarters:{ liabilities:{ currentLiabilities: Object JSON object used to wrap the previous quarter current liabilities information
quarterlyBalanceSheets:{ previousQuarters:{ liabilities:{ currentLiabilities:{ accountsPayable: String accounts payable
quarterlyBalanceSheets:{ previousQuarters:{ liabilities:{ currentLiabilities:{ shortTermDebt: String short term debt
quarterlyBalanceSheets:{ previousQuarters:{ liabilities:{ currentLiabilities:{ otherCurrentLiabilities: String other current liabilities
quarterlyBalanceSheets:{ previousQuarters:{ liabilities:{ liabilitySummary: Object JSON object used to wrap the previous quarter liability summary information
quarterlyBalanceSheets:{ previousQuarters:{ liabilities:{ liabilitySummary:{ totalCurrentLiabilities: String cash
quarterlyBalanceSheets:{ previousQuarters:{ liabilities:{ liabilitySummary:{ longTermDebt: String long term debt
quarterlyBalanceSheets:{ previousQuarters:{ liabilities:{ liabilitySummary:{ otherNonCurrentLiabilities: String other non current liabilities
quarterlyBalanceSheets:{ previousQuarters:{ liabilities:{ liabilitySummary:{ totalLiabilities: String total liabilities
quarterlyBalanceSheets:{ previousQuarters:{ shareholdersEquity: Object JSON object used to wrap the previous quarter share holders equity information
quarterlyBalanceSheets:{ previousQuarters:{ shareholdersEquity:{ equity: Object JSON object used to wrap the previous quarter equity information
quarterlyBalanceSheets:{ previousQuarters:{ shareholdersEquity:{ equity:{ preferredStockEquity: String preferred stock equity
quarterlyBalanceSheets:{ previousQuarters:{ shareholdersEquity:{ equity:{ commonStockEquity: String common stock equity
quarterlyBalanceSheets:{ previousQuarters:{ shareholdersEquity:{ equitySummary: Object JSON object used to wrap the previous quarter equity summary information
quarterlyBalanceSheets:{ previousQuarters:{ shareholdersEquity:{ equitySummary:{ totalEquity: String total equity
quarterlyBalanceSheets:{ previousQuarters:{ shareholdersEquity:{ equitySummary:{ sharesOutstanding: String shares outstanding
annualCashFlowStatements: Object JSON object used to wrap the annual cash flow statement information
annualCashFlowStatements:{ latestYear: Object JSON object used to wrap the latest year cash flow statement information
annualCashFlowStatements:{ latestYear:{ year: String year
annualCashFlowStatements:{ latestYear:{ cashAndCashEquivalentsAtTheBeginningOfTheYear: String cash and cash equivalents at the beginning of the year
annualCashFlowStatements:{ latestYear:{ netCashProvidedByOperatingActivities: String net cash provided by operating activities
annualCashFlowStatements:{ latestYear:{ netCashProvidedByInvestingActivities: String net cash provided by investing activities
annualCashFlowStatements:{ latestYear:{ netCashProvidedByFinancingActivities: String net cash provided by financing activities
annualCashFlowStatements:{ latestYear:{ netIncreaseDecreaseInCashAndCashEquivalents: String net increase decrease in cash and cash equivalents
annualCashFlowStatements:{ latestYear:{ cashAndCashEquivalentsAtTheEndOfTheYear: String cash and cash equivalents at the end of the year
annualCashFlowStatements:{ latestYear:{ capitalExpenditure: String capital expenditure
annualCashFlowStatements:{ previousYears: Object JSON objects used to wrap the previous years cash flow statement information
annualCashFlowStatements:{ previousYears:{ year: String year
annualCashFlowStatements:{ previousYears:{ cashAndCashEquivalentsAtTheBeginningOfTheYear: String cash and cash equivalents at the beginning of the year
annualCashFlowStatements:{ previousYears:{ netCashProvidedByOperatingActivities: String net cash provided by operating activities
annualCashFlowStatements:{ previousYears:{ netCashProvidedByInvestingActivities: String net cash provided by investing activities
annualCashFlowStatements:{ previousYears:{ netCashProvidedByFinancingActivities: String net cash provided by financing activities
annualCashFlowStatements:{ previousYears:{ netIncreaseDecreaseInCashAndCashEquivalents: String net increase decrease in cash and cash equivalents
annualCashFlowStatements:{ previousYears:{ cashAndCashEquivalentsAtTheEndOfTheYear: String cash and cash equivalents at the end of the year
annualCashFlowStatements:{ previousYears:{ capitalExpenditure: String capital expenditure
quarterlyCashFlowStatements: Object JSON object used to wrap the quarterly cash flow statement information
quarterlyCashFlowStatements:{ latestQuarter: Object JSON object used to wrap the latest quarter cash flow statement information
quarterlyCashFlowStatements:{ latestQuarter:{ quarterMonth: String quarter month
quarterlyCashFlowStatements:{ latestQuarter:{ quarterYear: String quarter year
quarterlyCashFlowStatements:{ latestQuarter:{ cashAndCashEquivalentsAtTheBeginningOfTheQuarter: String cash and cash equivalents at the beginning of the quarter
quarterlyCashFlowStatements:{ latestQuarter:{ netCashProvidedByOperatingActivities: String net cash provided by operating activities
quarterlyCashFlowStatements:{ latestQuarter:{ netCashProvidedByInvestingActivities: String net cash provided by investing activities
quarterlyCashFlowStatements:{ latestQuarter:{ netCashProvidedByFinancingActivities: String net cash provided by financing activities
quarterlyCashFlowStatements:{ latestQuarter:{ netIncreaseDecreaseInCashAndCashEquivalents: String net increase decrease in cash and cash equivalents
quarterlyCashFlowStatements:{ latestQuarter:{ cashAndCashEquivalentsAtTheEndOfTheQuarter: String cash and cash equivalents at the end of the quarter
quarterlyCashFlowStatements:{ latestQuarter:{ capitalExpenditure: String capital expenditure
quarterlyCashFlowStatements:{ previousQuarters: Object JSON objects used to wrap the previous quarter cash flow statement information
quarterlyCashFlowStatements:{ previousQuarters:{ quarterMonth: String quarter month
quarterlyCashFlowStatements:{ previousQuarters:{ quarterYear: String quarter year
quarterlyCashFlowStatements:{ previousQuarters:{ cashAndCashEquivalentsAtTheBeginningOfTheQuarter: String cash and cash equivalents at the beginning of the quarter
quarterlyCashFlowStatements:{ previousQuarters:{ netCashProvidedByOperatingActivities: String net cash provided by operating activities
quarterlyCashFlowStatements:{ previousQuarters:{ netCashProvidedByInvestingActivities: String net cash provided by investing activities
quarterlyCashFlowStatements:{ previousQuarters:{ netCashProvidedByFinancingActivities: String net cash provided by financing activities
quarterlyCashFlowStatements:{ previousQuarters:{ netIncreaseDecreaseInCashAndCashEquivalents: String net increase decrease in cash and cash equivalents
quarterlyCashFlowStatements:{ previousQuarters:{ cashAndCashEquivalentsAtTheEndOfTheQuarter: String cash and cash equivalents at the end of the quarter
quarterlyCashFlowStatements:{ previousQuarters:{ capitalExpenditure: String capital expenditure