SEC EDGAR

Overview

The SEC EDGAR Connector allows you to interact with the U.S. Securities and Exchange Commission’s EDGAR (Electronic Data Gathering, Analysis, and Retrieval) system. EDGAR is the official repository of filings, forms, and disclosures submitted by publicly traded companies and institutional investors.

This connector enables structured access to company metadata, filing histories, and standardized financial facts directly from the SEC.

The SEC EDGAR connector is commonly used for:

• Investment research – Access 10-K, 10-Q, 8-K, DEF 14A filings

• Financial analysis pipelines – Extract structured financial facts

• Compliance and monitoring – Track regulatory disclosures

• Corporate intelligence – Retrieve company identifiers and histories

All data is sourced directly from U.S. Securities and Exchange Commission public endpoints.

Connecting to SEC EDGAR

Authentication

The SEC EDGAR API does not require an API key.

However, the SEC requires a User-Agent header that identifies who is making the request.

In Stack AI, a connection can easily be created with your email.

Creating a New SEC EDGAR Connection

1. Click the SEC EDGAR node to open its settings

2. Select New connection

3. Enter the following required information

Field	Value
Connection Name	Any descriptive name (e.g. sec-edgar-connection)
User Agent	Your organization name and contact email (e.g. AcmeResearch [email protected])

⚠️ Important: Requests without a proper User-Agent may be throttled or blocked by the SEC.

No additional authentication or credentials are required.

Available Actions

The SEC EDGAR connector provides 3 core actions.

1. Lookup Company

Action ID: lookup_company_sec_edgar

Description Search for a company using a name, ticker symbol, or CIK and retrieve basic identifying information. This action is typically the first step in any SEC EDGAR workflow.

Inputs

Field	Type	Required	Description
Company Identifier	string	✅ Yes	Company name, ticker symbol (e.g. AAPL), or CIK (e.g. 0000320193). Partial and fuzzy matches are supported.

Outputs

Field	Type	Description
status_code	number	HTTP response status
headers	object	Response headers
body	object	Company metadata, including CIK, legal name, and identifiers

2. Get Company Filings

Action ID: get_company_filings_sec_edgar

Description Retrieve a company’s full SEC filing history using its CIK. Includes recent filings and historical submission metadata.

Inputs

Field	Type	Required	Description
Company CIK	string	✅ Yes	10-digit Central Index Key (CIK)

Outputs

Field	Type	Description
status_code	number	HTTP response status
headers	object	Response headers
body	object	Filing data including form types, dates, accession numbers, and document links

Common Filing Types Returned

• 10-K (Annual Report)

• 10-Q (Quarterly Report)

• 8-K (Current Events)

• DEF 14A (Proxy Statement)

• S-1 (IPO Registration)

• 4 (Insider Transactions)

• 13F (Institutional Holdings)

3. Get Company Facts

Action ID: get_company_facts_sec_edgar

Description Retrieve structured financial facts derived from XBRL-tagged SEC filings. This action returns standardized metrics such as revenue, assets, liabilities, and earnings.

Inputs

Field	Type	Required	Description
Company CIK	string	✅ Yes	10-digit Central Index Key (CIK)

Outputs

Field	Type	Description
status_code	number	HTTP response status
headers	object	Response headers
body	object	Structured financial facts organized by taxonomy and reporting period

Key Concepts

Central Index Key (CIK)

A CIK is a unique 10-digit identifier assigned by the SEC to each filing entity.

You can obtain a CIK by:

• Using Lookup Company with a name or ticker

• Providing it directly if already known

All other SEC EDGAR actions require a valid CIK.

Tips & Best Practices

• Always resolve to a CIK first – Tickers and names are not accepted by downstream actions

• Use Python for parsing – EDGAR responses are deeply nested JSON

• Combine with scraping – Filings metadata includes URLs, not full text

• Be respectful of rate limits – Use caching where possible

Summary Table

Action Name	Description	Key Inputs	Key Outputs
Lookup Company	Resolve name/ticker → CIK	Company name ticker, or CIK	Company metadata
Get Company Filings	Retrieve filing history	Company CIK	Filing list & links
Get Company Facts	Retrieve structured financial data	Company CIK	XBRL financial facts