--- source_url: "https://api-ninjas.com/api/sec?utm_source=openai" title: SEC API - API Ninjas mirrored_at: 2026-08-17T01:02:43.799Z host: api-ninjas.com cited_in_42a: true mirror_canonical: "https://index.42a.ai/api-ninjas.com/api/sec__q__utm_source_openai" --- > **Original source:** https://api-ninjas.com/api/sec?utm_source=openai (4.7) From 3,289 users 600+ Applications using this API API Status Online - All Systems Operational API Response Times Average P50 P75 P90 P95 396ms 408ms 451ms 831ms 1343ms Similar APIs * * * ## /v1/sec GET `https://api.api-ninjas.com/v1/sec` Returns a list of SEC filing information (including the submission URL) corresponding to the given search parameters. #### Parameters - ##### **`ticker`**  required Ticker symbol of the company to search (e.g. `AAPL` for Apple). - ##### **`filing`**  required SEC filing form type. The following values are supported: [`10-K`](https://api-ninjas.com/sec/10-k), [`10-Q`](https://api-ninjas.com/sec/10-q), [`8-K`](https://api-ninjas.com/sec/8-k), [`S-1`](https://api-ninjas.com/sec/s-1), [`S-3`](https://api-ninjas.com/sec/s-3), [`DEF14A`](https://api-ninjas.com/sec/def14a), [`13D`](https://api-ninjas.com/sec/13d), [`13F-HR`](https://api-ninjas.com/sec/13f), [`13G`](https://api-ninjas.com/sec/13g) - ##### **`start`**  optional [premium only](https://api-ninjas.com/pricing) Start date to search. Must be in `YYYY-MM-DD` format (e.g. `2023-04-01`). - ##### **`end`**  optional [premium only](https://api-ninjas.com/pricing) End date to search. Must be in `YYYY-MM-DD` format (e.g. `2023-04-01`). - ##### **`limit`**  optional [premium only](https://api-ninjas.com/pricing) Number of results to return from 1 to 100. By default, up to 2 results are returned. #### Headers - ##### **`X-Api-Key`**  required API Key associated with your account. #### Response A JSON array of objects, each containing the following fields, or [an error](https://api-ninjas.com/error-codes) if the request is unsuccessful. - ##### **`ticker`** Ticker symbol of the company. - ##### **`filing_date`** Date of the SEC filing in `YYYY-MM-DD` format. - ##### **`filing_url`** URL of the SEC filing. - ##### **`form_type`** Type of SEC filing. #### Sample Request Live Demo! Ticker ticker filing start end limit Try our APIs in the API playground Sign up for a free API key to get started — no credit card required. `https://api.api-ninjas.com/v1/sec?ticker=AAPL&filing=10-K` Headers `X-Api-Key``Log in or sign up to get your API Key` #### Sample Response **JSON** \[ { ticker:"AAPL", filing\_date:"2024-11-01", filing\_url:"https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm", form\_type:"10-K" }, { ticker:"AAPL", filing\_date:"2023-11-03", filing\_url:"https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/aapl-20230930.htm", form\_type:"10-K" } \] #### 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 a HTTP request library written in your programming language and following the above documentation. ## 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](https://api-ninjas.com/pricing) to choose a plan that fits your needs. - How do I get an API key and start using the SEC API? [Sign up](https://api-ninjas.com/register) for a free account to instantly get your API key, then pass it in the `X-Api-Key` header 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](https://api-ninjas.com/pricing). - 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](https://api-ninjas.com/error-codes) for the full list of codes and how to resolve each one, or [contact support](https://api-ninjas.com/contact) if you need help. - How do I search for a specific company's SEC filings? Send a GET request to the `/v1/sec` endpoint with the required `ticker` parameter (e.g. `AAPL` for Apple) and the required `filing` parameter specifying the form type such as `10-K`. See the [API list](https://api-ninjas.com/api) for related financial data endpoints. - What does the SEC API response include? It returns a JSON array of filing objects, each containing the `ticker`, the `filing_date` in `YYYY-MM-DD` format, the `filing_url` linking to the document on SEC.gov, and the `form_type`; an [error](https://api-ninjas.com/error-codes) is returned if the request is unsuccessful. - Can I limit results to a specific date range or number of filings? Yes, the optional `start` and `end` parameters (both in `YYYY-MM-DD` format) filter by date, and the optional `limit` parameter returns between 1 and 100 results; these are premium-only features available on a paid [plan](https://api-ninjas.com/pricing), otherwise up to 2 results are returned by default. - What are some use cases for the SEC API? You can pull links to filings like `10-K` annual and `10-Q` quarterly reports for fundamental analysis, due diligence, or compliance monitoring, and pair it with the [Earnings API](https://api-ninjas.com/api/earnings) or [Insider Trading API](https://api-ninjas.com/api/insidertrading) to build a fuller picture of a public company.