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

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

  • end  optional

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

  • contains  optional

    Query text to search within filings. Only filings containing the text will be returned.

  • limit  optional

    Number of results to return (by default, all results will be returned, but if you want to save bandwidth and increase response speed, you can use this parameter).

Headers

  • X-Api-Key  required

    API Key associated with your account.

Sample Request Live Demo!

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

Sample Response

JSON
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 [ { "accession_number": "0000320193-22-000108", "submission_url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019322000108/0000320193-22-000108.txt", "filing_url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019322000108/aapl-20220924.htm" }, { "accession_number": "0000320193-21-000105", "submission_url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019321000105/0000320193-21-000105.txt", "filing_url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019321000105/aapl-20210925.htm" }, { "accession_number": "0000320193-20-000096", "submission_url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019320000096/0000320193-20-000096.txt", "filing_url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019320000096/aapl-20200926.htm" }, { "accession_number": "0000320193-19-000119", "submission_url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019319000119/0000320193-19-000119.txt", "filing_url": "https://www.sec.gov/Archives/edgar/data/0000320193/000032019319000119/a10-k20199282019.htm" } ]

Code Examples

1 2 3 4 5 6 7 8 import requests api_url = 'https://api.api-ninjas.com/v1/sec?ticker=AAPL&filing=10-K' response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'}) if response.status_code == requests.codes.ok: print(response.text) else: print("Error:", response.status_code, response.text)

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.