Annual Report (10-K) SEC Filing API
Form 10-K is the comprehensive annual report that U.S. public companies must file with the SEC. It contains audited financial statements, a detailed business overview, risk factors, MD&A, and disclosures about executive compensation and corporate governance. Domestic large accelerated filers must file within 60 days of fiscal year-end; accelerated and non-accelerated filers have 75 and 90 days respectively. 10-K filings are the single most-cited primary source in equity research and fundamental analysis. The SEC Filing API returns 10-K filing URLs and dates for any public company by ticker.
From 3,289 users
Applications using this API
API Status
API Response Times
Average | P50 | P75 | P90 | P95 |
|---|---|---|---|---|
| 396ms | 408ms | 451ms | 831ms | 1343ms |
Didn't find what you were looking for? Suggest an improvement
/v1/sec GET
https://api.api-ninjas.com/v1/sec
Returns a list of 10-K SEC filings (including the submission URL) for the given company. Set filing=10-K to search for 10-K filings.
Parameters
tickerrequiredTicker symbol of the company to search (e.g.
AAPL).filingrequiredSEC filing form type. Use
10-Kto search for 10-K filings. See the full SEC API documentation for the complete list of supported form types.startoptional premium onlyStart date to search. Must be in
YYYY-MM-DDformat (e.g.2023-04-01).endoptional premium onlyEnd date to search. Must be in
YYYY-MM-DDformat (e.g.2023-04-01).limitoptional premium onlyNumber of results to return from 1 to 100. By default, up to 2 results are returned.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.
tickerTicker symbol of the company.
filing_dateDate of the SEC filing in
YYYY-MM-DDformat.filing_urlURL of the SEC filing.
form_typeType of SEC filing (e.g.
10-K).
Sample Request Live Demo!
https://api.api-ninjas.com/v1/sec?ticker=AAPL&filing=10-KHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
Code Examples
1
2
curl -X GET "https://api.api-ninjas.com/v1/sec?ticker=AAPL&filing=10-K" \
-H "X-Api-Key: YOUR_API_KEY"If your programming language is not listed in the Code Example above, you can still make API calls by using any HTTP request library and following the documentation above.
Frequently Asked Questions
Can I use the SEC API for commercial purposes?
Yes, but you must have a premium subscription. Commercial use of the SEC API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.How do I get an API key and start using the SEC API?
Sign up for a free account to instantly get your API key, then pass it in theX-Api-Keyheader on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.What happens if I exceed my quota for the month?
Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.What happens if a request to the SEC API fails?
The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.How do I search for a specific company's SEC filings?
Send a GET request to the/v1/secendpoint with the requiredtickerparameter (e.g.AAPLfor Apple) and the requiredfilingparameter specifying the form type such as10-K. See the API list for related financial data endpoints.What does the SEC API response include?
It returns a JSON array of filing objects, each containing theticker, thefiling_dateinYYYY-MM-DDformat, thefiling_urllinking to the document on SEC.gov, and theform_type; an error is returned if the request is unsuccessful.Can I limit results to a specific date range or number of filings?
Yes, the optionalstartandendparameters (both inYYYY-MM-DDformat) filter by date, and the optionallimitparameter returns between 1 and 100 results; these are premium-only features available on a paid plan, otherwise up to 2 results are returned by default.What are some use cases for the SEC API?
You can pull links to filings like10-Kannual and10-Qquarterly reports for fundamental analysis, due diligence, or compliance monitoring, and pair it with the Earnings API or Insider Trading API to build a fuller picture of a public company.