NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →
SEC API

Current Report (8-K) SEC Filing API

Form 8-K is the current report that U.S. public companies must file to disclose material events to shareholders between regularly scheduled reports. Triggering events include earnings releases, executive changes, acquisitions, bankruptcies, auditor changes, and Reg FD disclosures. 8-K filings are generally due within four business days of the triggering event. Because they capture market-moving news in near-real-time, 8-Ks are the most-watched SEC filing type by traders and event-driven investors. The SEC Filing API returns 8-K filing URLs and dates for any public company by ticker.

(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
396ms408ms451ms831ms1343ms

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 8-K SEC filings (including the submission URL) for the given company. Set filing=8-K to search for 8-K filings.

Parameters

  • ticker  required

    Ticker symbol of the company to search (e.g. AAPL).

  • filing  required

    SEC filing form type. Use 8-K to search for 8-K filings. See the full SEC API documentation for the complete list of supported form types.

  • start  optional premium only

    Start date to search. Must be in YYYY-MM-DD format (e.g. 2023-04-01).

  • end  optional premium only

    End date to search. Must be in YYYY-MM-DD format (e.g. 2023-04-01).

  • limit  optional premium only

    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 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 (e.g. 8-K).

Sample Request Live Demo!

ticker
filing
start
end
limit

Try this endpoint live with a free API key

Instant access — no credit card required.

https://api.api-ninjas.com/v1/sec?ticker=AAPL&filing=8-K

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
[
    {
      ticker:"AAPL",
      filing_date:"2026-04-30",
      filing_url:"https://www.sec.gov/Archives/edgar/data/320193/000032019326000011/a8-kex991q2202603282026.htm",
      form_type:"8-K"
    }
]

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/sec?ticker=AAPL&filing=8-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

  • 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.
  • Sign up 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.
  • 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.
  • 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.
  • 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 for related financial data endpoints.
  • 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 is returned if the request is unsuccessful.
  • 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, otherwise up to 2 results are returned by default.
  • 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 or Insider Trading API to build a fuller picture of a public company.