SEC API

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 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.

• 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/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.

• 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 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, 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 or Insider Trading API to build a fuller picture of a public company.