SEC EDGAR Filings List
CertifiedList a company's filings on SEC EDGAR
SEC EDGAR Filings List
List a company's filings on SEC EDGAR
Lists a company's filings, newest first, optionally filtered by form type and filing date. The company is given by ticker or cik. SEC returns at least the last year (or 1,000) of filings at once; older filings are read page by page, and only when startDate reaches them or more results are needed. Each filing has its accession number, form, dates, 8-K item numbers and the URL of its primary document.
SEC allows at most 10 requests per second from all your tools together; see maxRequestsPerSecond.
type: io.kestra.plugin.edgar.filings.ListExamples
List a company's 8-K filings since the start of the year.
id: edgar_list_8k
namespace: company.team
tasks:
- id: filings
type: io.kestra.plugin.edgar.filings.List
userAgent: "Example Co admin@example.com"
ticker: INTC
forms:
- 8-K
startDate: "{{ now() | date('yyyy') }}-01-01"
- id: log
type: io.kestra.plugin.core.log.Log
message: "{{ outputs.filings.size }} 8-K filings: {{ outputs.filings.rows | toJson }}"
Store a company's full 10-K and 10-Q history by CIK in internal storage.
id: edgar_list_history
namespace: company.team
tasks:
- id: filings
type: io.kestra.plugin.edgar.filings.List
userAgent: "Example Co admin@example.com"
cik: "320193"
forms:
- 10-K
- 10-Q
maxResults: 10000
fetchType: STORE
Properties
userAgent *string
User-Agent sent to SEC
SEC requires automated tools to identify themselves with a name and a contact email, for example Example Co admin@example.com, and rejects requests without one. See SEC fair access.
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150baseUrl string
https://www.sec.govBase URL of the SEC website
Where company tickers and filing documents are read from. Change it only to go through a proxy or a test server.
cik string
CIK of the company
With or without leading zeros, for example 50863 or 0000050863. Set either ticker or cik.
dataBaseUrl string
https://data.sec.govBase URL of SEC's data API
Where filing lists and XBRL data are read from. Change it only to go through a proxy or a test server.
endDate string
Latest filing date to keep
Inclusive, for example 2026-06-30.
fetchType string
FETCHSTOREFETCHFETCH_ONENONEHow to return the filings
FETCH (default) returns them in rows, FETCH_ONE returns the newest in row, STORE writes them to an ION file in internal storage and returns its uri, NONE returns only size.
forms array
Form types to keep
For example 8-K or 10-K, matched exactly and case-insensitively; amendments have their own form type, such as 10-K/A. All forms when empty.
maxRequestsPerSecond integerstring
5Maximum requests per second
Requests made by this task are spaced so they stay at or under this rate. Defaults to 5, at most 10, which is SEC's limit. The limit applies to each task run: tasks that run in parallel each count against SEC's limit, so lower this value when several EDGAR tasks run at the same time. A request rejected with HTTP 429 or 503 is retried after SEC's Retry-After delay, then up to twice more, 10 and 20 seconds later.
maxResults integerstring
100Maximum number of filings to return
The newest filings that match are returned first. Defaults to 100, at most 10000.
startDate string
Earliest filing date to keep
Inclusive, for example 2026-01-01.
ticker string
Ticker of the company
For example INTC. Set either ticker or cik.
Outputs
row
The newest matching filing
Set when fetchType is FETCH_ONE; empty when nothing matches.
io.kestra.plugin.edgar.filings.Filing
date-timeTime SEC accepted the filing
Accession number
SEC's identifier of the filing, for example 0000050863-26-000155.
CIK of the filer
The 10-digit zero-padded CIK.
dateDate the filing was made
Form type
For example 8-K, 10-Q or 10-K/A.
Item numbers
For an 8-K, the items it reports, for example 2.02 (results of operations); empty for most other forms.
File name of the primary document
uriURL of the primary document on SEC's website
datePeriod or event date the filing reports on
Empty when SEC lists none.
rows array
The matching filings, newest first
Set when fetchType is FETCH.
io.kestra.plugin.edgar.filings.Filing
date-timeTime SEC accepted the filing
Accession number
SEC's identifier of the filing, for example 0000050863-26-000155.
CIK of the filer
The 10-digit zero-padded CIK.
dateDate the filing was made
Form type
For example 8-K, 10-Q or 10-K/A.
Item numbers
For an 8-K, the items it reports, for example 2.02 (results of operations); empty for most other forms.
File name of the primary document
uriURL of the primary document on SEC's website
datePeriod or event date the filing reports on
Empty when SEC lists none.
size integer
Number of filings found
uri string
uriURI of the ION file holding the filings
Set when fetchType is STORE.
