Save over 30% when you subscribe to an annual subscription plan!

SEC API

The SEC API allows you to search millions of SEC filings from thousands of public companies.

/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
    10-Q
    S-1
    S-2
    S-3
    8-K
    DEF14A
    13D
  • 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

  • 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
filing
https://api.api-ninjas.com/v1/sec?ticker=AAPL&filing=10-K

Headers

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

Sample Response

JSON
1 2 3 4 5 6 7 8 9 10 11 12 13 14 [ { "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.