# 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 <contact@acme.com>) |

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

No additional authentication or credentials are required.

![](https://3697023207-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFSlso1Kjob5CLDrh0dVn%2Fuploads%2FqVuywNmJWb6HAqxgzmV3%2Funknown.png?alt=media\&token=7318ec9e-bdb1-4fe0-949e-cf6e713f706e)

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

<table data-header-hidden><thead><tr><th width="111.23828125"></th><th width="88.546875"></th><th width="106.63671875"></th><th></th></tr></thead><tbody><tr><td>Field</td><td>Type</td><td>Required</td><td>Description</td></tr><tr><td>Company Identifier</td><td>string</td><td>✅ Yes</td><td>Company name, ticker symbol (e.g. AAPL), or CIK (e.g. 0000320193). Partial and fuzzy matches are supported.</td></tr></tbody></table>

Outputs

<table data-header-hidden><thead><tr><th width="126.25"></th><th width="133.27734375"></th><th></th></tr></thead><tbody><tr><td>Field</td><td>Type</td><td>Description</td></tr><tr><td>status_code</td><td>number</td><td>HTTP response status</td></tr><tr><td>headers</td><td>object</td><td>Response headers</td></tr><tr><td>body</td><td>object</td><td>Company metadata, including CIK, legal name, and identifiers</td></tr></tbody></table>

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

<table data-header-hidden><thead><tr><th width="143.63671875"></th><th width="113.26953125"></th><th></th></tr></thead><tbody><tr><td>Field</td><td>Type</td><td>Description</td></tr><tr><td>status_code</td><td>number</td><td>HTTP response status</td></tr><tr><td>headers</td><td>object</td><td>Response headers</td></tr><tr><td>body</td><td>object</td><td>Filing data including form types, dates, accession numbers, and document links</td></tr></tbody></table>

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

<table data-header-hidden><thead><tr><th width="132.8828125"></th><th width="110.8671875"></th><th></th></tr></thead><tbody><tr><td>Field</td><td>Type</td><td>Description</td></tr><tr><td>status_code</td><td>number</td><td>HTTP response status</td></tr><tr><td>headers</td><td>object</td><td>Response headers</td></tr><tr><td>body</td><td>object</td><td>Structured financial facts organized by taxonomy and reporting period</td></tr></tbody></table>

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