> ## Documentation Index > Fetch the complete documentation index at: https://deepline.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # SEC EDGAR: List Filings > Finding recent annual, quarterly, current, ownership, or institutional SEC filings by company. Includes inputs, outputs, SDK V2 examples, and Deepline cost. Finding recent annual, quarterly, current, ownership, or institutional SEC filings by company. Tool ID: `sec_edgar_list_filings` ## Run this action This action has conditional or dynamic input fields that cannot be represented by a reliable static example. Inspect the live contract before executing it: ```bash theme={null} deepline tools get sec_edgar_list_filings --json ``` ## Example response The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative. ```json theme={null} { "company": { "cik": "example", "name": "Example", "tickers": [ "example" ], "exchanges": [ "example" ] }, "filings": [ { "accession_number": "example", "form": "example", "filed_at": "2026-01-15T12:00:00Z", "primary_document": "example", "filing_index_url": "https://example.com/resource", "primary_document_url": "https://example.com/resource" } ], "count": 123, "is_partial": true, "available_recent_count": 123, "historical_files": [ { "name": "Example" } ], "source_url": "https://example.com/resource" } ``` Use `deepline tools get sec_edgar_list_filings --json` for the latest machine-readable contract. ## Input reference | Name | Type | Required | Default | Details | | -------------------- | --------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------- | | `payload.ticker` | `string` | No | — | US-listed company ticker, resolved case-insensitively. Pattern: `^[A-Za-z][A-Za-z0-9.-]{0,14}$`. | | `payload.cik` | `string` | No | — | SEC Central Index Key, with or without leading zeroes. Pattern: `^[0-9]{1,10}$`. | | `payload.forms` | `array` | No | — | Optional exact SEC form filters, such as 10-K, 10-Q, or 8-K. Minimum items: 1. Maximum items: 20. Items must be unique. | | `payload.filed_from` | `string` | No | — | Optional inclusive filing-date lower bound. Format: `date`. | | `payload.filed_to` | `string` | No | — | Optional inclusive filing-date upper bound. Format: `date`. | | `payload.limit` | `integer` | No | `20` | Maximum filing records to return. Defaults to 20. Minimum: 1. Maximum: 100. |
Show raw input schema ### Input JSON Schema ```json theme={null} { "type": "object", "properties": { "ticker": { "type": "string", "description": "US-listed company ticker, resolved case-insensitively.", "pattern": "^[A-Za-z][A-Za-z0-9.-]{0,14}$" }, "cik": { "type": "string", "description": "SEC Central Index Key, with or without leading zeroes.", "pattern": "^[0-9]{1,10}$" }, "forms": { "type": "array", "description": "Optional exact SEC form filters, such as 10-K, 10-Q, or 8-K.", "minItems": 1, "maxItems": 20, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 20 } }, "filed_from": { "type": "string", "description": "Optional inclusive filing-date lower bound.", "format": "date" }, "filed_to": { "type": "string", "description": "Optional inclusive filing-date upper bound.", "format": "date" }, "limit": { "type": "integer", "description": "Maximum filing records to return. Defaults to 20.", "default": 20, "minimum": 1, "maximum": 100 } }, "required": [], "additionalProperties": false } ```
## Output reference | Name | Type | Required | Default | Details | | ----------------------------------------------- | --------- | -------- | ------- | ------------------------------------------------------------------------ | | `result.company` | `object` | Yes | — | Canonical SEC company identity resolved from a ticker or CIK. | | `result.company.cik` | `string` | Yes | — | Zero-padded 10-digit SEC CIK. | | `result.company.name` | `string` | Yes | — | SEC registrant name. | | `result.company.ticker` | `string` | No | — | Matched primary ticker. | | `result.company.tickers` | `array` | Yes | — | All tickers reported by the SEC for the registrant. | | `result.company.exchange` | `string` | No | — | Matched primary exchange. | | `result.company.exchanges` | `array` | Yes | — | All exchanges reported by the SEC for the registrant. | | `result.company.sic` | `string` | No | — | Standard Industrial Classification. | | `result.company.sic_description` | `string` | No | — | SEC description of the SIC industry. | | `result.company.fiscal_year_end` | `string` | No | — | Issuer fiscal year end as MMDD. | | `result.filings` | `array` | Yes | — | — | | `result.filings[].accession_number` | `string` | Yes | — | Stable SEC filing accession number. | | `result.filings[].form` | `string` | Yes | — | SEC form, such as 10-K or 10-Q. | | `result.filings[].filed_at` | `string` | Yes | — | SEC filing date. | | `result.filings[].accepted_at` | `string` | No | — | SEC acceptance timestamp. | | `result.filings[].report_date` | `string` | No | — | Period-of-report date declared by the filing. | | `result.filings[].items` | `string` | No | — | SEC form item identifiers. | | `result.filings[].size` | `integer` | No | — | Filing size in bytes. | | `result.filings[].primary_document` | `string` | Yes | — | Primary filing document name. | | `result.filings[].primary_document_description` | `string` | No | — | SEC description of the primary document. | | `result.filings[].is_xbrl` | `boolean` | No | — | Whether the filing uses XBRL. | | `result.filings[].is_inline_xbrl` | `boolean` | No | — | Whether the filing uses inline XBRL. | | `result.filings[].filing_index_url` | `string` | Yes | — | Authoritative SEC source URL. Format: `uri`. | | `result.filings[].primary_document_url` | `string` | Yes | — | Authoritative SEC source URL. Format: `uri`. | | `result.count` | `integer` | Yes | — | Number of filings returned. | | `result.is_partial` | `boolean` | Yes | — | True when more matching recent filings exist beyond the requested limit. | | `result.available_recent_count` | `integer` | Yes | — | Number of recent filing rows available before filtering. | | `result.historical_files` | `array` | Yes | — | — | | `result.historical_files[].name` | `string` | Yes | — | — | | `result.historical_files[].filing_from` | `string` | No | — | Oldest filing date advertised for this continuation. | | `result.historical_files[].filing_to` | `string` | No | — | Newest filing date advertised for this continuation. | | `result.source_url` | `string` | Yes | — | Authoritative SEC source URL. Format: `uri`. |
Show raw output schema ### Output JSON Schema ```json theme={null} { "type": "object", "properties": { "company": { "type": "object", "description": "Canonical SEC company identity resolved from a ticker or CIK.", "properties": { "cik": { "type": "string", "description": "Zero-padded 10-digit SEC CIK." }, "name": { "type": "string", "description": "SEC registrant name." }, "ticker": { "type": "string", "description": "Matched primary ticker." }, "tickers": { "type": "array", "description": "All tickers reported by the SEC for the registrant.", "items": { "type": "string" } }, "exchange": { "type": "string", "description": "Matched primary exchange." }, "exchanges": { "type": "array", "description": "All exchanges reported by the SEC for the registrant.", "items": { "type": "string" } }, "sic": { "type": "string", "description": "Standard Industrial Classification." }, "sic_description": { "type": "string", "description": "SEC description of the SIC industry." }, "fiscal_year_end": { "type": "string", "description": "Issuer fiscal year end as MMDD." } }, "required": [ "cik", "name", "tickers", "exchanges" ], "additionalProperties": false }, "filings": { "type": "array", "items": { "type": "object", "description": "One normalized SEC filing record.", "properties": { "accession_number": { "type": "string", "description": "Stable SEC filing accession number." }, "form": { "type": "string", "description": "SEC form, such as 10-K or 10-Q." }, "filed_at": { "type": "string", "description": "SEC filing date." }, "accepted_at": { "type": "string", "description": "SEC acceptance timestamp." }, "report_date": { "type": "string", "description": "Period-of-report date declared by the filing." }, "items": { "type": "string", "description": "SEC form item identifiers." }, "size": { "type": "integer", "description": "Filing size in bytes." }, "primary_document": { "type": "string", "description": "Primary filing document name." }, "primary_document_description": { "type": "string", "description": "SEC description of the primary document." }, "is_xbrl": { "type": "boolean", "description": "Whether the filing uses XBRL." }, "is_inline_xbrl": { "type": "boolean", "description": "Whether the filing uses inline XBRL." }, "filing_index_url": { "type": "string", "description": "Authoritative SEC source URL.", "format": "uri" }, "primary_document_url": { "type": "string", "description": "Authoritative SEC source URL.", "format": "uri" } }, "required": [ "accession_number", "form", "filed_at", "primary_document", "filing_index_url", "primary_document_url" ], "additionalProperties": false } }, "count": { "type": "integer", "description": "Number of filings returned." }, "is_partial": { "type": "boolean", "description": "True when more matching recent filings exist beyond the requested limit." }, "available_recent_count": { "type": "integer", "description": "Number of recent filing rows available before filtering." }, "historical_files": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "filing_from": { "type": "string", "description": "Oldest filing date advertised for this continuation." }, "filing_to": { "type": "string", "description": "Newest filing date advertised for this continuation." } }, "required": [ "name" ], "additionalProperties": false } }, "source_url": { "type": "string", "description": "Authoritative SEC source URL.", "format": "uri" } }, "required": [ "company", "filings", "count", "is_partial", "available_recent_count", "historical_files", "source_url" ], "additionalProperties": false } ```
## Deepline cost * Pricing model: `fixed` (per call). * Estimated Deepline credits: `0` per pricing unit. * Provider-native pricing may still exist outside Deepline credit billing. ## Related documentation * [SDK V2 quickstart](/docs/sdk-v2/quickstart) * [SDK reference](/docs/sdk-v2/sdk-reference) * [Run tools across a CSV](/docs/sdk-v2/batch-csv)