SEC EDGAR Filing Catalog

sec-edgar-filing-catalog enumerates public SEC EDGAR filings as canonical secFiling records. It is for agents and applications needing bounded, provenance-backed filing metadata—not filing prose, advice, ticker resolution, or a sibling-Actor workflow.

Local release status is READY_FOR_BETA; the Actor is not deployed and its Cloud lifecycle status remains planned.

Use it for

• Filing discovery by exact CIK.
• Direct resolution of an exact SEC accession.
• A bounded all filed-date window (at most 31 days).
• Monitoring after a prior opaque cursor, where the source can prove a safe continuation.

Use C01 to resolve a ticker or company name first. Use C03/C04 for filing documents or content, and a form-specific Actor for semantic interpretation.

Input and output

The executable schemas in ./.actor/ are authoritative. A minimal input is in ./.actor/examples/input-minimal.json. Each query has a unique requestId and one identifier strategy: cik, exact accession, or all with filedFrom and filedTo.

A CIK query without filed dates starts with a cursor-anchored rolling ten-year window. When older SEC history exists, SUMMARY.truncation.cursor continues into the next older window without changing the query. Explicit CIK filed-date and report-period ranges require both bounds and may span at most ten years.

Hard limits are 20 queries, 10,000 output records, 1,000 SEC source requests, and 50 MiB. Validation occurs before the adapter constructs an SEC client. Input order does not change the stable natural record ID sec-filing:<accession>; matching request IDs are sorted and deduplicated.

The default Dataset contains only confirmed secFiling records. SUMMARY and ERRORS are always written to the default Key-Value Store for empty, partial, and global failed runs as applicable. Output links expose all three locations. Examples: ./.actor/examples/output-success.json, ./.actor/examples/output-empty.json, and ./.actor/examples/summary-partial.json.

Sources and boundaries

Only the five inventoried public SEC paths are used: filing index, Company Submissions, Daily Index, Full Index, and Latest Filings. Every emitted record has confirmed SEC archive provenance. The Actor never accepts a user URL, contacts a third-party source, parses filing prose, resolves a ticker, or runs another Actor.

Pricing status

The local planned pay-per-event configuration has no events. The adapter therefore makes no charge calls and records chargedEvents: {} plus exact 0.000000 estimated and maximum user charge in every SUMMARY. This is not a Cloud pricing configuration and does not authorize publication or a price change.

Local development

Python 3.13 is required. apify==2.7.3 is exactly pinned with its resolved runtime closure in requirements.lock; development tools are pinned in requirements-dev.lock. The Docker entry point is python -m sec_edgar_filing_catalog.

PYTHONDONTWRITEBYTECODE=1 PYTHONPATH=src:vendor \
  ../sec-8k-event-normalizer/.venv/bin/python -m pytest
apify validate-schema

The checked-in 8-K virtual environment is a read-only local runner, not an installation target. See ./LOCKING.md, ./docs/product/interface.md, and ./docs/product/store-listing.md.