SEC Filings API

Receive an API key immediately and have access to the ETF Holdings data right away​

SEC Filings API: Features

The SEC Filings API provides access to both EDGAR links and SEC filings content stored in our database of financial statements and other reports SEC requires from companies, company insiders and broker-dealers to fill in periodically. Finnworlds SEC filings database contains historical records of reports from thousands of public companies and up-to-date filings. The SEC Filings API is a useful tool through which you are able to examine the complete account of SEC filings of a company starting historically from the IPO going forward and updated in real-time with new filings with respective reporting dates. No matter if you are an investor or not, SEC filings data comes in handy when evaluating a company and deciding whether to invest in it.

The API allows you to get SEC filings data on the exact company you are interested in based on its company CIK, ISIN, or its stock ticker symbol. In this way, you can focus on a specific company’s (or companies’) reports and build a platform where your clients can do the same.

You can further filter the data by entering the code of the form type you are interested in such as 10-K,10-Q, 8-K, Forms 3-4-5 etc. and pull these based on their year as well.

You can get data on a specific section of a filing without having to go over the whole report. You should either let the API get you directly to the website link of the relevant SEC filing on EDGAR, or request the complete content of the filing to be immediately retrievable via the SEC Filings API.

Check Developer Documentation

Code Examples for the SEC Report Filings API

				
					https://finnworlds.com/api/v1/secfilings
    ?key=YOUR-KEY
        &stock_ticker_symbol=AAPL&year=2021

{
    "status": {
        "message": "Success"
    },
    "results": [
        {
        "basics": {
            "name": "Apple Inc",
            "stock_ticker_symbol": "AAPL"
            "isin_identifier": "US0378331005"
            "exchange": "nasdaq"
            },
        "output": {
            "form_type": "10-Q"
            "title": "Quarterly Report [Sections 13 or 15(d)]"
            "link": "https://www.sec.gov/ix?doc=/Archives/edgar/data/0000320193/000032019321000056/aapl-20210327.htm"
            "filing_date": "2021-04-29"
            "reporting_date": "2021-03-27"
            },
            {
            "form_type": "8K"
            "title": "Quarterly Report [Sections 13 or 15(d)]"
            "link": "https://www.sec.gov/ix?doc=/Archives/edgar/data/0000320193/000032019321000056/aapl-20210327.htm"
            "filing_date": "2021-04-29"
            "reporting_date": "2021-03-27"
            },
            {
            "form_type": "10-Q"
            "title": "Quarterly Report [Sections 13 or 15(d)]"
            "link": "https://www.sec.gov/ix?doc=/Archives/edgar/data/0000320193/000032019321000056/aapl-20210327.htm"
            "filing_date": "2021-04-29"
            "reporting_date": "2021-03-27"

            },
        }
    ]
}
				
			

				
					https://finnworlds.com/api/v1/secfilings
    ?key=YOUR-KEY
        &isin_identifier=US0378331005&year=2021

{
    "status": {
        "message": "Success"
    },
    "results": [
        {
        "basics": {
            "name": "Apple Inc",
            "stock_ticker_symbol": "AAPL"
            "isin_identifier": "US0378331005"
            "exchange": "nasdaq"
            },
        "output": {
            "form_type": "10-Q"
            "title": "Quarterly Report [Sections 13 or 15(d)]"
            "link": "https://www.sec.gov/ix?doc=/Archives/edgar/data/0000320193/000032019321000056/aapl-20210327.htm"
            "filing_date": "2021-04-29"
            "reporting_date": "2021-03-27"
            },
            {
            "form_type": "8K"
            "title": "Quarterly Report [Sections 13 or 15(d)]"
            "link": "https://www.sec.gov/ix?doc=/Archives/edgar/data/0000320193/000032019321000056/aapl-20210327.htm"
            "filing_date": "2021-04-29"
            "reporting_date": "2021-03-27"
            },
            {
            "form_type": "10-Q"
            "title": "Quarterly Report [Sections 13 or 15(d)]"
            "link": "https://www.sec.gov/ix?doc=/Archives/edgar/data/0000320193/000032019321000056/aapl-20210327.htm"
            "filing_date": "2021-04-29"
            "reporting_date": "2021-03-27"
            },
        }
    ]
}
				
			

				
					https://finnworlds.com/api/v1/secfilings
    ?key=YOUR-KEY
        &isin_identifier=US0378331005&form_type=10-Q

{
    "status": {
        "message": "Success"
    },
    "results": [
        {
        "basics": {
            "name": "Apple Inc",
            "stock_ticker_symbol": "AAPL"
            "isin_identifier": "US0378331005"
            "exchange": "nasdaq"
            },
        "output": {
            "form_type": "10-Q"
            "title": "Quarterly Report [Sections 13 or 15(d)]"
            "link": "https://www.sec.gov/ix?doc=/Archives/edgar/data/0000320193/000032019321000056/aapl-20210327.htm"
            "filing_date": "2021-04-29"
            "reporting_date": "2021-03-27"
            },
            {            
            "form_type": "10-Q"
            "title": "Quarterly Report [Sections 13 or 15(d)]"
            "link": "https://www.sec.gov/ix?doc=/Archives/edgar/data/0000320193/000032019321000056/aapl-20210327.htm"
            "filing_date": "2021-01-29"
            "reporting_date": "2020-12-27"
            },
            {            
            "form_type": "10-Q"
            "title": "Quarterly Report [Sections 13 or 15(d)]"
            "link": "https://www.sec.gov/ix?doc=/Archives/edgar/data/0000320193/000032019321000056/aapl-20210327.htm"
            "filing_date": "2020-09-29"
            "reporting_date": "2020-08-27"
            },
            {            
            "form_type": "10-Q"
            "title": "Quarterly Report [Sections 13 or 15(d)]"
            "link": "https://www.sec.gov/ix?doc=/Archives/edgar/data/0000320193/000032019321000056/aapl-20210327.htm"
            "filing_date": "2020-05-29"
            "reporting_date": "2020-04-27"
            },
        }
    ]
}
				
			

ObjectsDescription
stock_ticker_symbolTicker of the security for which you want SEC filings
exchangeThe exchange platform where the security trades on
stock_isin_identifierISIN of the security for which you want search SEC filings of
form_typeThe type of filing you wish to receive (10Q, 10K, 8K, …)
dateChoose a specific date from which you want a filing.

Type of Reports in the SEC Filings API

Our SEC filings database contains all 200+ SEC filing types as submitted to the EDGAR system. The reports accessed via the Finnworlds SEC Filings API include the most common and important ones such as Form 10-K, 10-Q, 8-K, proxy statements, Forms 3,4, and 5, Schedule 13, Form 114, and Foreign Investment Disclosures. It is possible to get complete reports  separately by entering the form type and year. When you want to obtain data from only a section of the report, you can use additional filters to do so. The form descriptions of standard SEC reports may vary depending on the report. However, the “codes” of each section in a standard SEC form are the same. Since each form has a fixed table of contents with fixed codes for each segment, filtering the data through our SEC API is easy. For example, let’s say you’d like to view the “Properties” section from the 10-K report of Apple from the year 2020. You’d simply have to add in the endpoint “Apple”, “2020”, “10-K” and “Item 2” filters where “Properties” are disclosed in a standard 10-K form, and get the relevant content (or the EDGAR link) in that report. The relevant section will return in JSON format which you can use to display as text on your app, website, etc. Below is the table of contents of a 10-K form to better envision how this works:

Sign Up

The Table of Content of an SEC 10-K Form

Apple Inc.

Form 10-K

For the Fiscal Year Ended September 28, 2013

TABLE OF CONTENTS

 

       

 

 

 

  

Page

 

Part I

  

   

Item 1.

 

Business

  

 

1

  

Item 1A.

 

Risk Factors

  

 

9

  

Item 1B.

 

Unresolved Staff Comments

  

 

20

  

Item 2.

 

Properties

  

 

20

  

Item 3.

 

Legal Proceedings

  

 

21

  

Item 4.

 

Mine Safety Disclosures

  

 

21

  

 

Part II

  

   

Item 5.

 

Market for Registrant’s Common Equity, Related Stockholder Matters and Issuer Purchases of Equity Securities

  

 

22

  

Item 6.

 

Selected Financial Data

  

 

24

  

Item 7.

 

Management’s Discussion and Analysis of Financial Condition and Results of Operations

  

 

25

  

Item 7A.

 

Quantitative and Qualitative Disclosures About Market Risk

  

 

42

  

Item 8.

 

Financial Statements and Supplementary Data

  

 

44

  

Item 9.

 

Changes in and Disagreements With Accountants on Accounting and Financial Disclosure

  

 

81

  

Item 9A.

 

Controls and Procedures

  

 

81

  

Item 9B.

 

Other Information

  

 

82

  

 

Part III

  

   

Item 10.

 

Directors, Executive Officers and Corporate Governance

  

 

83

  

Item 11.

 

Executive Compensation

  

 

83

  

Item 12.

 

Security Ownership of Certain Beneficial Owners and Management and Related Stockholder Matters

  

 

83

  

Item 13.

 

Certain Relationships and Related Transactions and Director Independence

  

 

83

  

Item 14.

 

Principal Accounting Fees and Services

  

 

83

  

 

Part IV

  

   

Item 15.

 

Exhibits, Financial Statement Schedules

    
Sign Up

Usage of the SEC Filings API

Even though EDGAR is a fairly useful system to ensure transparency and keep company documents available for the public, it is hard to navigate through it. Moreover, it would take you a lot of time to access a single document. However, Finnworlds SEC Filings API works in your favour and unlike EDGAR does not have such a drawback. The API accesses our SEC filings database and returns you the exact data segment of a report, the complete report, or links to all SEC reports of a company as stored in the EDGAR database all within seconds. 

Another advantage of the SEC Filings API is that it is compatible and works very efficiently together with our extensive list of financial APIs such as the Company Stock Price API, Stock Technical Indicators API, Company Details API, Financial Reports API, ETF and Mutual Fund Holdings API, Income Statements API, Balance Sheet API. If you decide to integrate the SEC Filings API with the other APIs, you will get all-in-one data making you effectively evaluate the investing potential in a stock along with its future price. The APIs essentially offer all the data you may need to analyze stocks. 

Formats to Download the Data

The SEC filings data is accessible in three main formats. In this way, Finnworlds fully addresses your needs for data delivery formats. Request your data format and get SEC filings data instantly. No matter the format of your choice, you obtain SEC filings data without any differences in the data transfer time. Please, contact support@finnworlds.com for notifying which data format you prefer. You can always change the data delivery format.  

Contact us
Excel and CSV
If you choose this data format, you will access SEC filings data through database downloads formatted as either Excel or CSV files.
E-mail link
If you choose this data format, you will receive an email containing a link through which you can download SEC filings data.
Pdf Report
If you choose this data format, you will get SEC filings data in a downloadable PDF report.

Developer Notes

The SEC Filings API is a REST API that returns data in JSON format. The API connects to our database for the links and the data  segments of SEC filings requested where they are stored, maintained and updated. The response times are fast at around 0.3 but may differ based on the load of the data requested in one API call. You can access data anytime and build a project where your clients can receive the data they are looking for with server uptimes at around 99.5%.

SDKs and Devkits

The API works with: Javascript, JQuery, VueJS, Angular, JAVA, PHP, NodeJS, Python, Go, Ruby, C#, R, Strest, Rust, Swift and Scala

REST JSON and XML

Data output can be requested in REST Json format or XML format

Excel and CSV

In case you do not want the data through our API, request it in Excel or CSV format.

SEC Filings API - Get started!

Access the SEC Filings API and all other financial data APIs with a single API key you may get below in a minute. Once you register, your personal API key will be automatically sent to your email address, already activated to use right away. Benefit from the trial rates to test the APIs and start developing with low prices. Update or cancel your plan anytime without commitments depending on how you like the data. Click below to get started!

Control the Data

/analystratings&stock_ticker_symbol= GOOG AAPL AMZN TSLA NFLX SQ AMD FB MSFT

stock_ticker_symbol= GOOG AAPL AMZN TSLA NFLX SQ AMD FB MSFT