Companies Metadata

Companies Metadata

Overview

The Companies Data draws from the Core Financials dataset, providing general descriptive information from all U.S. publicly traded companies. Coverage includes both SEC filers and exclusive access to OTC listed filers.  This dataset is specifically designed to allow for easy comparability across companies, while still providing the depth of detail needed for a thorough analysis. Data is extracted from 8-K, 10-K, 10-Q, 20-F, S-1 and other SEC and OTC filings and, after being processed by a rules-based programming engine. This process ensures a consistent set of key data elements and ratios that are comparable across all industries and sectors.

This resource provides basic metadata information about companies from Core Financials and Full Financials resources

Parameter Name Filter Name Resource Has Description Description
fields
companies
List of the fields to display or remove from the response; example: fields=companyname,cik
filter
companies
Use this parameter to filter the result set; example: filter=primarysymbol eq msft
entityids entityid companies true Search companies’ metadata based on entityids, separated by comma
ciks cik companies true Search companies’ metadata based on CIKs, separated by comma
primarysymbols primarysymbol companies true Search companies’ metadata based on primary symbols, separated by comma
industries industry companies true Search companies’ metadata based on industries, separated by comma
sectors sector companies true Search companies’ metadata based on sectors, separated by comma
primaryexchanges primaryexchange companies true Search companies’ metadata based on primary exchanges, separated by comma
marketoperators marketoperator companies true Retrieve the exchange on which a security is traded. Parameter might be specified as comma separated list of values.
markettiers markettier companies true Retrieve the tier within the market, which may indicate market-specific listing criteria. Parameter might be specified as comma separated list of values.
siccodes siccide companies true Search companies’ metadata based on SIC Codes, separated by comma
cities city companies true Search companies’ metadata based on cities, separated by comma
postalcodes zipcode companies true Search companies’ metadata based on postal codes, separated by comma
countries country companies true Search companies’ metadata based on countries, separated by comma
states state companies true Search companies’ metadata based on state, separated by comma
primarycusips primarycusip companies true Search companies’ metadata based on primary CUSIPs, separated by comma
companynames companyname companies true Search companies’ metadata based on company names, separated by comma
activecompanies
companies
Search companies’ metadata based on active companies; example: activecompanies =true
modifiedsince
companies
Search companies’ metadata based on modified since date range; example: 20141001~20131001
sortby
companies
Use this parameter to sort result set; example: sortby companyname desc
limit
companies
Limit is used with paging and defines the number of rows to return in a single call
offset
companies
Offset is used with paging and defines which page number to serve based on the total numbers of rows and the limit

Get Companies Metadata using CIKs parameter:

http://edgaronline.api.mashery.com/v2/companies?ciks=0001090872&appkey={APPKEY}

Or Get Companies Metadata using CIK as filter parameter:

http://edgaronline.api.mashery.com/v2/companies?filter=cik eq "0001090872"&appkey={APPKEY}

Get Companies Metadata using entityids parameter:

http://edgaronline.api.mashery.com/v2/companies?entityids=8244&appkey={APPKEY}

Or Get Companies Metadata using entityid as filter parameter:

http://edgaronline.api.mashery.com/v2/companies?filter=entityid eq 8244&appkey={APPKEY}

Get Companies Metadata using primarysymbols parameter:

http://edgaronline.api.mashery.com/v2/companies?primarysymbols=MSFT&appkey={APPKEY}

Or Get Companies Metadata using primarysymbols as filter parameter:

http://edgaronline.api.mashery.com/v2/companies?filter=primarysymbol eq "MSFT"&appkey={APPKEY}

Get Companies Metadata using industries parameter with skipped special characters and whitespaces:

http://edgaronline.api.mashery.com/v2/companies?industries=InsuranceMiscellaneous,InsuranceLife&appkey={APPKEY}

Or Get Companies Metadata using industry as filter parameter:

http://edgaronline.api.mashery.com/v2/companies?filter=industry in ("Insurance (Miscellaneous)","Insurance (Life)")&appkey={APPKEY}

Get Companies Metadata using sectors parameter with skipped special characters and extra whitespaces:

http://edgaronline.api.mashery.com/v2/companies?sectors=Consumer Non Cyclical&appkey={APPKEY}

Or Get Companies Metadata using sector as filter parameter:

http://edgaronline.api.mashery.com/v2/companies?filter=sector eq "Consumer/Non-Cyclical"&appkey={APPKEY}

Get Companies Metadata using primaryexchanges parameter:

http://edgaronline.api.mashery.com/v2/companies?primaryexchanges=NYSE&companynames=*micro*&appkey={APPKEY}

Or Get Companies Metadata using primaryexchange filter parameter:

http://edgaronline.api.mashery.com/v2/companies?filter=primaryexchange eq "NYSE"&companynames=*micro*&appkey={APPKEY}

Get Companies Metadata using marketoperators parameter:

http://edgaronline.api.mashery.com/v2/companies?marketoperators=OTC Markets&companynames=*micro*&appkey={APPKEY}

Or Get Companies Metadata using marketoperator filter parameter:

http://edgaronline.api.mashery.com/v2/companies?filter=marketoperator eq "NASDAQ"&companynames=*micro*&appkey={APPKEY}

Get Companies Metadata using markettiers parameter:

http://edgaronline.api.mashery.com/v2/companies?markettiers=OTCQB&companynames=*micro*&appkey={APPKEY}

Or Get Companies Metadata using markettier filter parameter:

http://edgaronline.api.mashery.com/v2/companies?filter=markettier in ("NASDAQ Capital Market","NASDAQ Global Market")&companynames=*micro*&appkey={APPKEY}

Get Companies Metadata using siccodes parameter:

http://edgaronline.api.mashery.com/v2/companies?siccodes=3825&appkey={APPKEY}

Or Get Companies Metadata using siccode as filter parameter:

http://edgaronline.api.mashery.com/v2/companies?filter=siccode eq "3825"&appkey={APPKEY}

Get Companies Metadata using cities parameter:

http://edgaronline.api.mashery.com/v2/companies?cities=SANTA CLARA&appkey={APPKEY}

Or Get Companies Metadata using city as filter parameter:

http://edgaronline.api.mashery.com/v2/companies?filter=city eq "SANTA CLARA"&appkey={APPKEY}

Get Companies Metadata using countries parameter:

http://edgaronline.api.mashery.com/v2/companies?countries=UNITED STATES OF AMERICA&companynames=*micro*&appkey={APPKEY}

Or Get Companies Metadata using country as filter parameter:

http://edgaronline.api.mashery.com/v2/companies?filter=country eq "UNITED STATES OF AMERICA"&companynames=*micro*&appkey={APPKEY}

Get Companies Metadata using states parameter:

http://edgaronline.api.mashery.com/v2/companies?states=California&companynames=*micro*&appkey={APPKEY}

Or Get Companies Metadata using state as filter parameter:

http://edgaronline.api.mashery.com/v2/companies?filter=state eq "California"&companynames=*micro*&appkey={APPKEY}

Get Companies Metadata using primarycusips parameter:

http://edgaronline.api.mashery.com/v2/companies?primarycusips=xxxxxxx&appkey={APPKEY}

Or Get Companies Metadata using primarycusip as filter parameter:

http://edgaronline.api.mashery.com/v2/companies?filter=primarycusip eq "xxxxxxx"&appkey={APPKEY}

Get Companies Metadata using companynames parameter:

http://edgaronline.api.mashery.com/v2/companies?companynames=AGILENT TECHNOLOGIES INC&appkey={APPKEY}

Or Get Companies Metadata using companyname as filter parameter:

http://edgaronline.api.mashery.com/v2/companies?filter=companyname eq "AGILENT TECHNOLOGIES INC"&appkey={APPKEY}

Get Companies Metadata using activecompanies parameter:

http://edgaronline.api.mashery.com/v2/companies?activecompanies=true&siccodes=3825&appkey={APPKEY}

Or Get Companies Metadata using isactivecompany as filter parameter:

http://edgaronline.api.mashery.com/v2/companies?filter=isactivecompany eq true&siccodes=3825&appkey={APPKEY}

Get Companies Metadata using Deleted parameter:

http://edgaronline.api.mashery.com/v2/companies?Deleted=true&siccodes=3825&appkey={APPKEY}

Or Get Companies Metadata using isDeleted as filter parameter:

http://edgaronline.api.mashery.com/v2/companies?filter=isDeleted eq false&siccodes=3825&appkey={APPKEY}

Get Companies Metadata using sortby parameter:

http://edgaronline.api.mashery.com/v2/companies?sortby=companyname&siccodes=3825&appkey={APPKEY}

Get Companies Metadata using limit parameter:

http://edgaronline.api.mashery.com/v2/companies?sortby=companyname&limit=25&siccodes=3825&appkey={APPKEY}

Get Companies Metadata using offset parameter:

Page 1 - 25

http://edgaronline.api.mashery.com/v2/companies?sortby=companyname&limit=25&offset=0&siccodes=3825&appkey={APPKEY}

Page 26 - 50

http://edgaronline.api.mashery.com/v2/companies?sortby=companyname&limit=25&offset=25&siccodes=3825&appkey={APPKEY}

JSON Response:

{  
   "result":{  
      "totalrows":1,
      "rows":[  
         {  
            "rownum":1,
            "values":[  
               {  
                  "field":"cik",
                  "value":"0000789019"
               },
               {  
                  "field":"companyname",
                  "value":"MICROSOFT CORP"
               },
               {  
                  "field":"entityid",
                  "value":8528
               },
               {  
                  "field":"primaryexchange",
                  "value":"Nasdaq Global Market"
               },
               {  
                  "field":"primarysymbol",
                  "value":"MSFT"
               },
               {  
                  "field":"siccode",
                  "value":"7372"
               },
               {  
                  "field":"sicdescription",
                  "value":"Prepackaged Software"
               }
            ]
         }
      ]
   }
}