EDGAR®Online DataFied API Version 1

Introduction

Welcome to DataFied, your one stop shop for financial data and information. To get started, here are the details for the datasets and resources available through the DataFied API.  The Core Dataset includes company details, primary financials and ratios.  The companies included in the dataset are all SEC reporting companies with traded securities.  To complement the SEC filers, we provide exclusive access to the OTC traded securities.  Data is available back to 1999 for SEC reporting companies and 2009 for OTC filers.  The table below highlights the datasets and verbs associated with them.

An application key is needed to make calls and pull the data.  To register for an application key, please click here.  Once registered, you will be able to access the datasets; all application keys will be entitled initially to our evaluation plan data package.  The evaluation plan - Developer HackPack - includes access to our consolidated financial statements – balance sheet, income statement and cash flow statement – for the most recent 5 years.  In addition, we provide complementary company descriptive metadata information.  The evaluation plan data is available via each of the resources.    

Once you get started, we can work with you on adding additional data fields, time periods or depth of history based on your data needs.

Happy Coding!

Datasets Actions Description
Companies GET Includes Company Metadata and descriptive data such as: Company Name, CIK, Ticker, Address, Description, Sector, Industry, etc.
CoreFinancials GET Includes Companies’ primary financial statements - Balance Sheet, Income Statement, Cash Flow Statement  and Ratios.
CompanySets GET, POST, PUT, DELETE Allows user to save a list of companies to be used later or optimize the request call.
ParameterSets GET, POST, PUT, DELETE Allows user to save the entire request, helps in shortening the URL.
Descriptions GET Provide description lookup call for a Company Name, SIC code,  Industry or Sector

Our API allows you to:

  • Perform metadata or financial data searches for a supplied search term such as company name.
  • Perform metadata or financial searches for a supplied company ticker, CUSIP or CIK.
  • Perform targeted searches that match user defined tags and location terms.
  • Retrieve individual company’s descriptive information, financials and/or ratios.
Name Description Required Default Values
Protocol HTTP and HTTPS Yes
Endpoints Path to API method Yes Each API call is documented under each API resources
Response format API response to the format Yes JSON|XML, Default response is JSON
API Key Authorized API Key Yes  

URI Examples

https://datafied.api.edgar-online.com/v1/companies?primarysymbols=MSFT&appkey={APPKEY}

https://datafied.api.edgar-online.com/v1/companies?entityids=8528&appkey={APPKEY}

https://datafied.api.edgar-online.com/v1/companies?primarysymbols=msft,appl&appkey={APPKEY}

https://datafied.api.edgar-online.com/v1/corefinancials?primarysymbols=msft&conceptgroups=balancesheetfull&appkey={APPKEY}

HTTP Status Description
400 Bad Request – Please check the request that is submitted.
403 Forbidden – Server failed to authenticate for the given appkey or the resources.
404 Not Found – The specified resource is not found. Please check the request.
503 Service Unavailable – The server is currently unable to receive requests. Please retry your request.

 

Status: 400 Bad Request
{
    Message"Request is invalid, you are trying to search by an obsolete or not supported parameters: (xxxxxxxxxx)."
}

 

All API keys are assigned a quota of 2 API calls/second.  Upon registration, all API keys will have access to the free evaluation plan data and will be limited to 5,000 API calls/day. The Evaluation Plan includes the following data -

  • Consolidate balance sheet,
  • Income statement and
  • Cash flow for all securities for the most recent year

Additionally, we provide basic descriptive company metadata. We do increase rate limits for partners on a case-by-base basis.  In order to increase the rate limit for a particular application, we need to verify your compliance with our Terms of Service and branding guidelines.  EDGAR Online will work with developers to establish an appropriate calls/day rate limit based on use case and data entitlements. If you would like to increase your API rate limit, please email us.

Debug

Debug parameter helps developers investigate what happened during the call and what items were substituted if any during the call.
https://datafied.api.edgar-online.com/v1/companies?companynames=*micro*&limit=10&appkey={APPKEY}&debug=true

 

debug: {
     appkey: "{ appkey }"
     userid: "null"
     primarysymbols: "msft"
     duration: "ANN"
     numperiods: "4"
     limit: "25"
     sortby: "PRIMARYSYMBOL,PERIODENDDATE DESC"
     fields: "USDConversionRate,Restated,...."
     OperationContextId: "a890a640-917a-40f4-932b-2e8153b37dd6"
}

 

Debug Response

Pagination

When the amount of data is more that system defined rows, data pagination occurs. Navigation to certain row is done via two parameters in the request for any resource (limit, offset). Limit defined the number of rows to be returned and offset defines which page to navigate. Every result will display the total number of rows in the system.

Example:

 

https://datafied.api.edgar-online.com/v1/companies?companynames=*micro*&limit=10&appkey={APPKEY} – will return all the companies metadata that contains a company name (micro), total of 10 rows per call.

 

To navigate to the page 1 of the request you will user offset = 10 will start the data from 11 – 20, offset = 20 will start the data from 21 - 30

 

https://datafied.api.edgar-online.com/v1/companies?companynames=*micro*&limit=10&offset=10&appkey={APPKEY}

 

SortBy:

All resources support the sort by parameter as a filter to the request. User can sort by any given requested field if they are entitled for it.

Example:

 

https://datafied.api.edgar-online.com/v1/companies?companynames=*micro*&limit=10&offset=10&sortby=entityid&appkey={APPKEY}

 

Negation:

Negation defines "exclude or include" any additional field in the response.

Negation are defined by adding a ! in-front of the fields parameter, if including any additional fields then just specify the fieldname without ! in the fields parameter. Please note that user must be entitled for the field if they are adding any fields in response.

Example:

 

to add primarysymbols in response
https://datafied.api.edgar-online.com/v1/corefinancials?primarysymbols=MSFT&fields=primarysymbol&conceptgroups=primaryfinancials&appkey={APPKEY}

 

 

to add primarysymbols and city
https://datafied.api.edgar-online.com/v1/corefinancials?primarysymbols=MSFT,AAPL&fields=primarysymbol,city&conceptgroups=primaryfinancials&appkey={APPKEY}

 

 

to remove primarysymbols from the response
https://datafied.api.edgar-online.com/v1/corefinancials?primarysymbols=MSFT&fields=!primarysymbol&conceptgroups=primaryfinancials&appkey={APPKEY}

 

 

to add primarysymbols and remove city from the response
https://datafied.api.edgar-online.com/v1/corefinancials?primarysymbols=MSFT,AAPL&fields=primarysymbol,!city&conceptgroups=primaryfinancials&appkey={APPKEY}

 

Concept groups reflect the logical grouping of the fields in the dataset into smaller categories to formulate calls for financial statements or company descriptive information.  The concept groups tie to product packages and entitlements and are designed to be a logical reflection of how the financial data ties together.  For example, if your application renders primary financial statements, you can leverage the Balance Sheet, Income Statement and/or Cash Flow Statement concept groups to easily call for all fields that would populate the rending of a statement.

With a free evaluation key, the consolidated balance sheet, consolidated cash flow statement, consolidated income statement and free metadata is included for the most recent annual timeframe.  For access to deeper history, more financials, additional descriptive data or ratios, please contact us to modify the entitlements associated with your application key. 

The table below outlines the various concept groups available through the dataset.  For the free evaluation dataset, the consolidated financial statement data concept groups are included. 

Concept Group Name Description
All All All financial, metadata and ratio fields. 
Primary Financials PrimaryFinancials Financial fields that populate the balance sheet, income statement and cash flow statements.  Inclusive of the Financial Header and Financial Ratio concept groups, providing contextual reference for the financials reported.
Balance Sheet BalanceSheetFull All fields and data points related to a company’s income statement, including revenues and expenses.
Consolidated Balance Sheet BalanceSheetConsolidated A subset of the balance sheet fields; typically supports a public website or business media outlet publishing company financials.  This concept group is available for free evaluation as the most recent annual financials for all SEC and OTC securities. 
Income Statement IncomeStatementFull All fields and data points related to a company’s income statement, including revenues and expenses.
Consolidated Income Statement IncomeStatementConsolidated A subset of the income statement fields; typically supports a public website or business media outlet publishing company financials.  This concept group is available for free evaluation as the most recent annual financials for all SEC and OTC securities.
Cash Flow Statement CashFlowStatementFull All fields and data point related to a company’s cash flow, including cash flows from investing, operating and financing activities.
Consolidated Cash Flow Statement CashFlowStatementConsolidated A subset of the cash flow statement fields; typically supports a public website or business media outlet publishing company financials.  This concept group is available for free evaluation as the most recent annual financials for all SEC and OTC securities.
Contextual Financial Header Data FinancialHeaderData Descriptive information associated This concept group is available for free evaluation as the most recent annual financials for all SEC and OTC securities.
Market Driven Financial Ratios FinancialRatioData General performance ratios for a company, included with a company’s financials. 
Ratios Ratios Company specific ratios including valuation, profitability, leverage, growth, activity and daily. 
Valuation ValuationRatios Ratios tracking the value of a security.
Mini Valuation Ratios ValuationRatiosMini A subset of the most commonly used valuation ratios, tracking the value of a security.
Profitability ProfitabilityRatios Ratios tracking the profitability of a security.
Mini Profitability Ratios ProfitabilityRatiosMini A subset of the most commonly used profitability ratios, providing profitability metrics on a specific security.
Leverage LeverageRatios Ratios tracking the debt and leverage of a security.
Mini Leverage Ratios LeverageRatiosMini A subset of the most commonly used leverage ratios, tracking the debt and leverage of a security. 
Liquidity LiquidityRatios Ratios tracking the liquidity of a company.
Mini Liquidity Ratios LiquidityRatiosMini A subset of the most commonly used liquidity ratios. 
Growth GrowthRatios Ratios tracking the growth of a security; available for multiple timeframes.
Activity ActivityRatios Ratios tracking company activity, such as inventory turnover.
Daily DailyRatios Ratios reflecting pricing history for the equity.
General Descriptive Metadata Metadata Descriptive and general company information including business descriptions
Basic Company Identification Fields MetadataFree Descriptive and general company information, including primary ticker, company name and entity ID.  This concept group is available for free evaluation.
CUSIP Cusip This is a single field concept group; because of the license required by The CUSIP Bureau to use these unique identifiers, this is a separate entitlement that can be provided upon receipt of a CUSIP license. 
Financial Headers FinancialHeaderData Descriptive information associated with security and its period end date. 
Financial Ratios FinancialRatioData General performance ratios for a company, included with a company’s financials. 

For additional details on concept groups, available fields, ratios and ratio calculations, please contact EDGAR Online’s support team at contactsupport@edgar-online.com or call us at  800.416.6651 or  212.658.5710 (outside of the US) Monday – Friday from 9 am to 5 pm EST.

Note: Do not combine timeperiod together, for example (periodenddate and fiscalperiod).

Example (this is an invalid call):

 

https://datafied.api.edgar-online.com/v1/corefinancials?primarysymbols=MSFT&periodenddate=20100101&fiscalperiod=2011q1~2012q2&appkey={APPKEY}

 

Parameter Name Resource Description
ciks companies Search companies metadata using single cik or list of ciks separated by comma.
companynames companies Search companies metadata using company name.  Search supports Starts with, Contains and Ends With.
entityids companies Search companies metadata using single entityid or list of entityids separated by comma.
primarysymbols companies Search companies metadata using single primarySymbol or list of primarySymbols separated by comma.
industries companies Search companies metadata using single industry or list of industries separated by comma.
sectors companies Search companies metadata using single sector or list of sectors separated by comma.
siccodes companies Search companies metadata using single siccode or list of siccodes separated by comma.
primarycusips companies Search companies metadata using single primarycusip or list of primarycusips separated by comma.
primaryexchanges companies Search companies metadata using single primaryexchange or list of primaryexchanges separated by comma.
cities companies Search companies metadata using single city or list of cities separated by comma.
postalcodes companies Search companies metadata using single postalcode or list of postalcodes separated by comma.
countries companies Search companies metadata using single country or list of countries separated by comma.
states companies Search companies metadata using single state or list of states separated by comma.
companysets companies Company sets are user specific. Developers can create a list of company in a set and execute that in a query. Search companies metadata using single companyset or list of companysets separated by comma.
offset companies Offset is used with paging. Offset defines which page number to serve based to total number of rows and limit.
limit companies Limit is used with paging. Limit defines the number of rows to return in a single call.
fields companies Fields are used as a filter in the request. Field can be used to add or suppress the fields in the response.
sortby companies Sortby is a filter in the request to sort the data ascending or descending.
parametersets companies Parameter sets are user specific. Developers can create a request string and save that as parameter set and execute that in a query using parametersets. This will help user preserve the multiple queries and execute by their name when needed.

 

Search by CIK
https://datafied.api.edgar-online.com/v1/companies?ciks=0000320193,0001018724,0000789019&appkey={APPKEY}

 

Search by companyName

 

StartsWith
Get the list of all companies that starts with "micro"
https://datafied.api.edgar-online.com/v1/companies?companynames=micro*&appkey={APPKEY}

 

 

contains
Get the list of all companies that contains a "soft" in companyname
https://datafied.api.edgar-online.com/v1/companies?companynames=*soft*&appkey={APPKEY}

 

 

endswith
Get the list of all company metadata that ends with "holdings" in companyname
https://datafied.api.edgar-online.com/v1/companies?companynames=*holdings&appkey={APPKEY}

 

 

Search by EntityID: https://datafied.api.edgar-online.com/v1/companies?entityids=8528&appkey={APPKEY}

 

 

Search by PrimarySymbols: https://datafied.api.edgar-online.com/v1/companies?primarysymbols=MSFT&appkey={APPKEY}

 

 

Search by Sectors: https://datafied.api.edgar-online.com/v1/companies?sectors=Technology&states=California&appkey={APPKEY}

 

 

Search by CIKs: https://datafied.api.edgar-online.com/v1/companies?ciks=0000789019&appkey={APPKEY}

 

 

Search by ZIP codes: https://datafied.api.edgar-online.com/v1/companies?zipcodes=98052,94111&appkey={APPKEY}

 

 

Search by countries: https://datafied.api.edgar-online.com/v1/companies?countries=France,Germany&appkey={APPKEY}

 

 

Search by states: https://datafied.api.edgar-online.com/v1/companies?states=Illinois,Michigan&appkey={APPKEY}

 

 

Search by companysets: https://datafied.api.edgar-online.com/v1/companies?companysets=PeerRetailers&appkey={APPKEY}

 

 

Search by parametersets: https://datafied.api.edgar-online.com/v1/companies?parametersets=NYSE_OilGas&appkey={APPKEY}

 

 

Search by Industries: https://datafied.api.edgar-online.com/v1/companies?industries=Investment Services&appkey={APPKEY}

 

 

Get all ActiveCompanies https://datafied.api.edgar-online.com/v1/companies?activecompanies=false&industries=Investment Services&appkey={APPKEY}

 

Companies JSON Response

JSON response for the companies’ resource is flat in nature.

 

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

 

Parameter Name Resource Description
entityids corefinancials Retrieve financial information using single entityid or list of entityids separated by comma, for specified fields or conceptgroups. If none of these are specified then default concept group is used.
primarysymbols corefinancials Retrieve financial information using single primarysymbol or list of primarysymbols separated by comma, for specified fields or conceptgroups. If none of these are specified then default concept group is used.
primaryexchanges corefinancials Retrieve financial information using single primaryexchange or list of primaryexchanges separated by comma, for specified fields or conceptgroups. If none of these are specified then default concept group is used.
companysets corefinancials Company sets are user specific. Developers can create a list of company in a set and execute that in a query. Retrieve financial information using single companysets or list of companysets separated by comma, for specified fields or conceptgroups. If none of these are specified then default concept group is used.
parametersets corefinancials Parameter sets are user specific. Developers can create a request string and save that as parameter set and execute that in a query using parametersets. Retrieve financial information using single parameterset or list of parametersets separated by comma, for specified fields or conceptgroups. If none of these are specified then default concept group is used.
numperiods corefinancials Numperiod defines the timeperiod for which the financial information to be retrieved for specified fields or conceptgroups. If none of these are specified then default concept group is used. For example to retrieve 3 years of history specify numperiods=3 & duration=ANNL, for 3 years of quarterly data specify numperiods =12&duration=QTR.
periodenddate corefinancials Retrieve financial information for specified fields or conceptgroups based on the financial year end. If none of these are specified then default concept group is used. For example to retrieve data for period end date ( 7/1/2012) specify periodenddate=20120701.
fiscalperiod corefinancials Retrieve financial information for specified fields or conceptgroups based on  fiscal year and it's quarter defined by FYQ1,FYQ2..,If none of these are specified then default concept group is used. For example to retrieve data between fiscal period of 2010 Q1 and 2012 Q4, specify fiscalperiod=2010q1~2012q4.
conceptgroups corefinancials Concept groups are the grouping of the fields to formulate the financial statements. Available concept groups are :
duration corefinancials Retrieve the financial information based on duration. Available durations are QTY, ANN, TTM, YTD
offset corefinancials Offset is used with paging. Offset defines which page number to server based to total numbers of rows and limit.
limit corefinancials Limit is used with paging. Limit defines the number of rows to return in a single call.
fields corefinancials Fields are used as a filter in the request. Field can be used to add or suppress the fields in the response.
sortby corefinancials Sortby is a filter in the request to sort the data ascending or descending.

 

Entity Id:
https://datafied.api.edgar-online.com/v1/corefinancials?entityids=8528&appkey={APPKEY}

 

 

PrimarySymbols:
https://datafied.api.edgar-online.com/v1/corefinancials?primarysymbols=MSFT&appkey={APPKEY}

 

 

PrimaryExchanges:
https://datafied.api.edgar-online.com/v1/corefinancials?primaryexchanges=NYSE&duration=ann&periodenddate=20141231&activecompanies=true&appkey={APPKEY}

 

 

CompanySets:
https://datafied.api.edgar-online.com/v1/corefinancials?companysets=PeerRetailers&appkey={APPKEY}

 

 

ParameterSets:
https://datafied.api.edgar-online.com/v1/corefinancials?parametersets=TopOilGasQuarterly&appkey={APPKEY}

 

Numperiod:

 

2 years of annual data for given symbol – Default concept group
https://datafied.api.edgar-online.com/v1/corefinancials?primarysymbols=MSFT&numperiods=2&duration=ANN&appkey={APPKEY}

 

 

2 years of quarterly data for given symbol – Default concept group
https://datafied.api.edgar-online.com/v1/corefinancials?primarysymbols=MSFT&numperiods=8&duration=QTR&appkey={APPKEY}

 

 

PeriodEndDate:
https://datafied.api.edgar-online.com/v1/corefinancials?primarysymbols=MSFT&periodenddate=20100101&appkey={APPKEY}

 

 

FiscalPeriod:
https://datafied.api.edgar-online.com/v1/corefinancials?primarysymbols=MSFT&fiscalperiod=2011q1~2013q4&appkey={APPKEY}

 

 

ConceptGroups:
https://datafied.api.edgar-online.com/v1/corefinancials?primarysymbols=MSFT&conceptgroups=balancesheets&appkey={APPKEY}

 

 

Duration:
https://datafied.api.edgar-online.com/v1/corefinancials?primarysymbols=MSFT&duration=QTR&appkey={APPKEY}

 

Fields:

 

Aggregation:
https://datafied.api.edgar-online.com/v1/corefinancials?primarysymbols=MSFT&fields=FiscalYear,FiscalQuarter,TotalRevenue,NetIncome&appkey={APPKEY}

 

 

Negation:
https://datafied.api.edgar-online.com/v1/corefinancials?primarysymbols=MSFT&fields=!ReceivedDate,!Restated&conceptgroups=primaryfinancials&appkey={APPKEY}

 

 

SortBy:
https://datafied.api.edgar-online.com/v1/corefinancials?primarysymbols=MSFT&duration=QTR&sortby=fiscalYear,fiscalQuarter&appkey={APPKEY}

 

CoreFinancial JSON Response

JSON response for the corefinancials resource is in grouping based on concept groups. This helps developers identify which fields belongs to a given concept group.

 

{
  "debug": {
    "appkey": "{appkey}",
    "userid": "null",
    "primarysymbols": "msft",
    "duration": "ANN",
    "numperiods": "4",
    "limit": "25",
    "sortby": "PRIMARYSYMBOL,PERIODENDDATE DESC",
    "fields": "CIK,Companyname,...",
    "OperationContextId": "03559534-5313-466c-8b30-9e6bcd5df6cd"
  },
  "result": {
    "totalrows": "4",
    "duration": "ANN",
    "rowset": [
      {
        "rownum": 1,
        "entityid": 8528,
        "groups": [
          {
            "conceptgroups": [
              "Metadata",
              "MetadataFree"
            ],
            "fiscalyear": 2013,
            "fiscalquarter": 4,
            "values": [
              {
                "type": "string",
                "field": "CIK",
                "value": "0000789019",
                "label": "CIK"
              },
              {
                "type": "string",
                "field": "Companyname",
                "value": "MICROSOFT CORP",
                "label": "Company name"
              },
              {
                "type": "string",
                "field": "PrimaryExchange",
                "value": "Nasdaq Global Market",
                "label": "Primary Exchange"
              },
              {
                "type": "string",
                "field": "PrimarySymbol",
                "value": "MSFT",
                "label": "Primary Symbol"
              },
              {
                "type": "string",
                "field": "SICCode",
                "value": "7372",
                "label": "SIC Code"
              },
              {
                "type": "string",
                "field": "SICDescription",
                "value": "Prepackaged Software",
                "label": "SIC Description"
              }
            ]
          },
          .....



        ]
      }
    ]
  }
}

 

Parameter set resource helps developers store the search queries to be used later.

Verbs supported by Parametersets are: GET, POST, PUT and DELETE

Required Parameter: appkey - Application key that has access to the resources
resource - for which resource the sets are being created for

POST: Create a new parameter set named NYSE_OilGas for resource "companies"
https://datafied.api.edgar-online.com/v1/parametersets/NYSE_OilGas?primaryexchanges=nyse&industries=Oil%20%26%20Gas%20-%20Integrated&resource=companies&appkey={APPKEY}

POST: Create a new parameter set named TopOilGasQuarterly for resource "corefinancials" 
https://datafied.api.edgar-online.com/v1/parametersets/TopOilGasQuarterly?primarysymbols=BP,CVX,RDS'A&duration=qtr&resource=corefinancials&appkey={APPKEY}

PUT: Update the existing set
https://datafied.api.edgar-online.com/v1/parametersets/NYSE_OilGas?primaryexchanges=nyse&industries=Oil%20%26%20Gas%20-%20Integrated&countries=united%20states%20of%20america&resource=companies&appkey={APPKEY}

DELETE: Delete the existing parametersets
https://datafied.api.edgar-online.com/v1/parametersets/NYSE_OilGas?appkey={APPKEY}

GET: Get the existing parameterset
https://datafied.api.edgar-online.com/v1/parametersets/NYSE_OilGas?appkey={APPKEY}

GET: Get all the existing parameter set for a given appkey
https://datafied.api.edgar-online.com/v1/parametersets?appkey={APPKEY}

Companysets resource allows user to save a set of given companies as their predefined list to be used in future. These are considered as a saved query. Companysets slightly differs from parameter set where parametersets are specific to resource but companysets are global, it does not require a parameter resource while creating, updating or deleting.

Verbs Supported by CompanySets resources are: PUT, POST, DELETE, GET

 

POST: Create new companysets based on entityid
https://datafied.api.edgar-online.com/v1/companysets/PeerRetailers?entityids=10592,95767&appkey={APPKEY}

 

 

POST: Create new companysets based on primarysymbols
https://datafied.api.edgar-online.com/v1/companysets/PeerRetailers?primarysymbols=M,MAKSY&appkey={APPKEY}

 

 

PUT: Update existing companyset
https://datafied.api.edgar-online.com/v1/companysets/PeerRetailers?primarysymbols=M,MAKSY,WMT&appkey={APPKEY}

 

 

DELETE: Delete existing companyset
https://datafied.api.edgar-online.com/v1/companysets/PeerRetailers?appkey={APPKEY}

 

 

GET : Get the existing companyset
https://datafied.api.edgar-online.com/v1/companysets/PeerRetailers?appkey={APPKEY}

 

 

GET: Get all the companies sets
https://datafied.api.edgar-online.com/v1/companysets?appkey={APPKEY}

 

Description resource allows users to perform a lookup for Sectors, Companies, Industries, Countries, CIK and States.
Verb Supported by Description Resource: Get

Parameter for Description Resource
descriptionType - Defines which items to perform lookup.
limit - Number of rows to be returned.
offset - Which page number to return
sortby - Sort the data by wither (description, id or mnemonic)

 

GET:
https://datafied.api.edgar-online.com/v1/description?descriptionType=sectors&appkey={APPKEY} 
https://datafied.api.edgar-online.com/v1/description?descriptionType=companies&appkey={APPKEY} 
https://datafied.api.edgar-online.com/v1/description?descriptionType=ciks&appkey={APPKEY}

 

Description JSON Response

 

{
  "totalrows": "18102",
  "limit": "100",
  "offset": "0",
  "values": [
    {
      "id": "0001163675",
      "mnemonic": "0001163675",
      "description": "0001163675"
    },
    {
      "id": "0001163680",
      "mnemonic": "0001163680",
      "description": "0001163680"
    },
    {
      "id": "0001163698",
      "mnemonic": "0001163698",
      "description": "0001163698"
    }
  ]
}

 

Concept Group Developer HackPack Partners
All Data Points
Primary Financials
Balance Sheet
Balance Sheet - Consolidated
Income Statement 
Income Statement - Consolidated
Cash Flow Statement
Cash Flow Statement - Consolidated
Ratios
Valuation Ratios
Valuation Ratios - Mini
Profitability Ratios
Profitability Ratios - Mini
Leverage Ratios
Leverage Ratios - Mini
Growth Ratios
Activity Ratios
Daily Ratios
Liquidity Ratios
Liquidity Ratios - Mini
Metadata
Metadata - Free
Financial Header Data
Financial Ratio Data
CUSIP
Rate Limit 2 calls/second 2 calls/second
Calls per Day 5,000 Flexible
Depth of History 5 years Flexible
Timeframes Annual, Quarterly Flexible
Scope of Coverage SEC, OTC SEC, OTC
Other API Key expires after 2 weeks

Available data packages work across all availalble resources.  An API Key is required to run test calls in the Make Live API Calls.  In addition to the product packages and concept groups, the EDGAR Online data is available with the following entitlements:

  • Depth of History: Most recent financials, 3 years, 5 years, 10 years or all (back to 1999)
  • Duration: Annual and/or quarterly financials, as well as Year-to-Data and Trailing Twelve Months (TTM)