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.
SEC Filings on Specific Companies
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.
Filtering the SEC Filing Data
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.
Segments of the SEC reports
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.
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"
},
}
]
}
| Objects | Description |
| stock_ticker_symbol | Ticker of the security for which you want SEC filings |
| exchange | The exchange platform where the security trades on |
| stock_isin_identifier | ISIN of the security for which you want search SEC filings of |
| form_type | The type of filing you wish to receive (10Q, 10K, 8K, …) |
| date | Choose 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:
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 |
| |
| ||||||
Item 1. |
|
|
| 1 |
| |
Item 1A. |
|
|
| 9 |
| |
Item 1B. |
|
|
| 20 |
| |
Item 2. |
|
|
| 20 |
| |
Item 3. |
|
|
| 21 |
| |
Item 4. |
|
|
| 21 |
| |
| ||||||
Item 5. |
|
|
| 22 |
| |
Item 6. |
|
|
| 24 |
| |
Item 7. |
| Management’s Discussion and Analysis of Financial Condition and Results of Operations |
|
| 25 |
|
Item 7A. |
|
|
| 42 |
| |
Item 8. |
|
|
| 44 |
| |
Item 9. |
| Changes in and Disagreements With Accountants on Accounting and Financial Disclosure |
|
| 81 |
|
Item 9A. |
|
|
| 81 |
| |
Item 9B. |
|
|
| 82 |
| |
| ||||||
Item 10. |
|
|
| 83 |
| |
Item 11. |
|
|
| 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. |
|
|
| 83 |
| |
| ||||||
Item 15. |
| |||||
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.
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
REST JSON and XML
Excel and CSV
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