SEC EDGAR filings — company search + recent filings (API)

One row per SEC filing, read live from the SEC's public EDGAR APIs — no key, no scraping. Two modes:

• by_company — give tickers, CIKs or company names; the Actor resolves them through the SEC's ticker file and lists each company's filings from the submissions API, newest first, filtered by form type (10-K, 8-K, S-1, 4, …) and filing date. The 1,000 most recent filings come in one request and are all that is scanned unless you give a date bound (date_from / date_to), which also reaches the company's older filing files (back to 1994 for long-listed companies) while your record budget lasts.
• full_text — search the text of filings and exhibits since 2001 with EDGAR full-text search ("workforce reduction", boolean operators, wildcards) and get one row per matching document, with the filing's index page and the matched document's URL.

Metadata only. The rows describe filings as the SEC publishes them; the Actor does not read or interpret the documents themselves.

Data source and status

Publisher	U.S. Securities and Exchange Commission, EDGAR
Ticker / name resolution	https://www.sec.gov/files/company_tickers.json (exchange-traded companies; refreshed by the SEC on its own schedule, read live each run)
Company filings	https://data.sec.gov/submissions/CIK##########.json (+ the older per-company files it lists) — the SEC updates these throughout the day as filings are accepted
Full-text search	https://efts.sec.gov/LATEST/search-index — the EDGAR full-text search API behind https://efts.sec.gov/LATEST/search-index and https://www.sec.gov/edgar/search/; filings since 2001, indexed within minutes of acceptance; at most 10,000 hits per query
Refresh cadence	Live on every run; fetched_at is the fetch time
Copyright	Works of the United States Government are not subject to copyright in the U.S. (17 U.S.C. §105). Filing metadata is public record; the filings' own documents may contain third-party material — cite the SEC and the filer
Known caveats	Form types match exactly as filed (10-K/A is listed separately from 10-K). The ticker file lists exchange-traded companies only — use a CIK for others. In full-text mode primary_document is null; matched_document names the document (often an exhibit) that matched, and form_type is the filing's root form

Identification: the SEC requires a descriptive User-Agent with a contact address. Every request carries RetrainMap data actor info@steelyardclinical.com as User-Agent and the contact address again in the standard From: header. The SEC's fair-access limit is 10 requests per second; the Actor stays at or below 5 per second (default interval 250 ms).

Input

Field	Type	Meaning
mode	by_company / full_text	Default by_company
tickers	array	Tickers or numeric CIKs (AAPL, 0000320193)
company_names	array	Resolved against the ticker file: exact name, else a name containing every word given; several matches fail the run and list them
form_types	array	Optional exact form types. Empty = all
date_from / date_to	YYYY-MM-DD	Optional inclusive filing-date bounds. full_text: empty = 2001-01-01 to today
query	string	full_text only (required there). EDGAR full-text syntax: phrases in double quotes, AND / OR / NOT, * wildcards
max_records	integer	Default 300; at most 10,000 (full-text cap per query)
request_interval_ms	integer	Default 250 (floor 200)
contact_email	string	Sent in the From: header

Examples:

{ "mode": "by_company", "tickers": ["AAPL", "MSFT"], "form_types": ["10-K", "8-K"], "max_records": 100 }

{ "mode": "full_text", "query": "\"workforce reduction\"", "form_types": ["8-K"],
  "date_from": "2026-06-01", "max_records": 500 }

Output (dataset row)

cik (10 digits), company_name, ticker, form_type, filing_date, report_date (period of report), accepted_at, accession_number, primary_document, matched_document (full-text mode), document_type (the form, or the matched document's type such as EX-99.1), description, items (8-K item numbers as a list, e.g. ["2.05", "9.01"]), file_number, film_number, all_ciks (co-registrants), filing_url (the filing's index page), document_url, source (submissions-api / full-text-search), fetched_at.

A run summary (resolved companies or the search parameters, the search's own match count, request count) is stored as RUN_SUMMARY in the run's key-value store.

Pricing (pay per event)

Event	Price
run-start — once per run	$0.10
record — per row written	$0.005

A 300-row pull costs $1.60. Rows stop when your run's maximum charge is reached; the run summary says so.

Operator

Steelyard Ventures LLC (RetrainMap) — info@steelyardclinical.com. The Actor writes only to its own dataset and key-value store; it stores no credentials and sends nothing else.