---
canonical_url: "https://docs.composio.dev/toolkits/sec"
markdown_url: "https://docs.composio.dev/toolkits/sec.md"
product: "platform"
version: null
last_updated: null
---

# SEC EDGAR

Access public SEC EDGAR company submissions, XBRL facts, filing archives, and filing indexes with the caller identity required by the SEC fair-access policy.

- **Category:** business intelligence
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 9
- **Triggers:** 0
- **Slug:** `SEC`
- **Version:** 00000000_00

## Tools

### Get SEC Company Concept

**Slug:** `SEC_GET_COMPANY_CONCEPT`

Resolve a ticker or CIK and return a bounded page of one company's disclosures for a specific standardized XBRL taxonomy concept.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag` | string | Yes | Case-sensitive XBRL concept tag, such as Assets or AccountsPayableCurrent. |
| `unit` | string | No | Optional exact unit key to include, such as USD, shares, or USD/shares. |
| `forms` | array | No | Optional SEC form types to include, such as 10-K or 10-Q. |
| `limit` | integer | No | Maximum disclosure records to return in this page (1-100). |
| `cursor` | string | No | Opaque continuation cursor returned by a previous call with the same filters. |
| `filed_to` | string | No | Latest SEC filing date to include, in YYYY-MM-DD format. |
| `taxonomy` | string | Yes | Case-sensitive standard taxonomy, such as us-gaap, ifrs-full, dei, or srt. |
| `filed_from` | string | No | Earliest SEC filing date to include, in YYYY-MM-DD format. |
| `company_identifier` | string | Yes | Company ticker or CIK; CIK may be padded or unpadded. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get SEC Company Profile

**Slug:** `SEC_GET_COMPANY_PROFILE`

Resolve a ticker or CIK and return the SEC filer's identity, classification, addresses, tickers, exchanges, and filing-history coverage without returning its filing arrays.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company_identifier` | string | Yes | Company ticker or CIK; CIK may be padded or unpadded. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get SEC Filing Document

**Slug:** `SEC_GET_FILING_DOCUMENT`

Resolve a filing path and offload one archive file, filing detail page, complete submission, or SGML header while enforcing a caller-selected size cap.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `max_bytes` | integer | No | Maximum document size in bytes (up to 10 MB). Listed sizes are checked before download when available, and every response is bounded while reading. |
| `document_kind` | string ("archive_file" | "filing_detail" | "complete_submission" | "sgml_header") | No | Document to retrieve: an archive filename, the filing detail HTML, the complete submission text, or the SGML header. |
| `document_name` | string | No | Exact filename returned by SEC_LIST_FILING_DOCUMENTS; required only when document_kind is archive_file. |
| `accession_number` | string | Yes | SEC accession number with or without dashes. |
| `company_identifier` | string | Yes | Company ticker or CIK; CIK may be padded or unpadded. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get SEC XBRL Frame

**Slug:** `SEC_GET_XBRL_FRAME`

Compare one standardized XBRL concept across reporting entities for a calendar period and return a bounded page of matching facts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag` | string | Yes | Case-sensitive XBRL concept tag to compare across entities. |
| `unit` | string | Yes | XBRL unit, such as USD, shares, pure, or USD-per-shares for a ratio. |
| `limit` | integer | No | Maximum entity facts to return in this page (1-100). |
| `cursor` | string | No | Opaque continuation cursor returned by a previous call with the same frame and filters. |
| `period` | string | Yes | Calendar frame: CY#### for annual duration, CY####Q# for quarterly duration, or CY####Q#I for an instant. |
| `location` | string | No | Optional exact SEC location code to include, such as US-CA. |
| `taxonomy` | string | Yes | Case-sensitive standard taxonomy, such as us-gaap or ifrs-full. |
| `company_query` | string | No | Optional case-insensitive company-name fragment or exact padded or unpadded CIK to include. Ticker symbols are not available in frame data. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List SEC Company Filings

**Slug:** `SEC_LIST_COMPANY_FILINGS`

Resolve a ticker or CIK and return one bounded, normalized page of recent or historical SEC company filings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `forms` | array | No | Optional SEC form types to include, such as 10-K, 10-Q, or 8-K. |
| `limit` | integer | No | Maximum normalized filing records to return in this page (1-100). |
| `cursor` | string | No | Opaque continuation cursor returned by a previous call. When continuing, repeat the same company_identifier, forms, filed_from, filed_to, and limit values; the cursor advances through recent filings and linked history files. |
| `filed_to` | string | No | Latest filing date to include, in YYYY-MM-DD format. |
| `filed_from` | string | No | Earliest filing date to include, in YYYY-MM-DD format. |
| `company_identifier` | string | Yes | Company ticker or CIK; CIK may be padded or unpadded. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List SEC Filing Documents

**Slug:** `SEC_LIST_FILING_DOCUMENTS`

Resolve a ticker or CIK and list a bounded page of documents and generated artifacts in one SEC filing archive, including filenames and sizes needed for safe retrieval.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum archive items to return in this page (1-200). |
| `cursor` | string | No | Opaque continuation cursor returned by a previous call with the same filing and filter. |
| `name_query` | string | No | Optional case-insensitive filename fragment to filter archive items. |
| `accession_number` | string | Yes | SEC accession number with or without dashes, such as 0000320193-25-000079. |
| `company_identifier` | string | Yes | Company ticker or CIK; CIK may be padded or unpadded. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search SEC Company Concepts

**Slug:** `SEC_SEARCH_COMPANY_CONCEPTS`

Resolve a ticker or CIK and search the company's available standardized XBRL concepts. Returns a bounded page of concept metadata and units without returning individual disclosure arrays or values.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum matching concepts to return in this page (1-100). |
| `query` | string | No | Case-insensitive text to match against the concept tag, label, or description; omit to browse from the start. |
| `cursor` | string | No | Opaque continuation cursor returned by a previous call with the same search. |
| `taxonomy` | string | No | Optional taxonomy to include, such as us-gaap, ifrs-full, dei, or srt. |
| `company_identifier` | string | Yes | Company ticker or CIK; CIK may be padded or unpadded. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search SEC Entities

**Slug:** `SEC_SEARCH_ENTITIES`

Search SEC companies by ticker, name, or CIK, or mutual funds by ticker, CIK, series ID, or class ID. Returns normalized identifiers for other SEC tools.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum matching records to return in this page (1-100). |
| `query` | string | Yes | Company ticker, name, or CIK, or mutual-fund ticker, CIK, series ID, or class ID to match case-insensitively. |
| `cursor` | string | No | Opaque continuation cursor returned by a previous call with the same search. |
| `exchange` | string | No | For companies, return only records on this exchange, such as Nasdaq or NYSE. |
| `entity_type` | string ("company" | "mutual_fund") | No | Entity dataset to search: operating/public companies or mutual-fund series and classes. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search SEC Filing Index

**Slug:** `SEC_SEARCH_FILING_INDEX`

Discover and search one daily or quarterly EDGAR master index, returning a bounded page filtered by company, CIK, or form. Quarterly source files over 30 MB are not supported; use a daily index instead.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Business date in YYYY-MM-DD format; required for a daily index and used to discover the exact YYYYMMDD filename. |
| `year` | integer | No | Four-digit filing year; required for a quarterly index. |
| `forms` | array | No | Optional SEC form types to include, such as 10-K, 10-Q, or 8-K. |
| `limit` | integer | No | Maximum matching filing records to return in this page (1-100). |
| `cursor` | string | No | Opaque continuation cursor returned by a previous call with the same period and filters. |
| `quarter` | integer | No | Calendar quarter 1-4; required for a quarterly index. |
| `index_period` | string ("daily" | "quarterly") | Yes | Search one business day's index or a cumulative calendar-quarter index. Quarterly source files over 30 MB are not supported; use a daily index instead. |
| `company_query` | string | No | Optional case-insensitive company-name fragment or exact CIK to include. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |