SEC EDGAR Filings — 10-K, 10-Q, 8-K, 13F, S-1 by ticker + full-text search

Pull SEC filings for any EDGAR registrant as clean JSON — by ticker, CIK or company name — or search the text of every filing since 2001 for a phrase ("cybersecurity incident", a competitor's name, "going concern"). Each item carries form type, dates, 8-K item codes, accession number and every useful link (primary document, filing index, full submission .txt, XBRL viewer). Built for AI agents and analysts. No API key, no proxy, no browser — only the public SEC endpoints, used within SEC fair-use limits.

Use cases

• 8-K event monitoring — daily run over a watchlist with itemCodes: ["1.05","4.02","5.02"] to catch cyber incidents, restatements and executive departures the day they are filed.
• Keyword surveillance across the market — fullTextSearch for "ransomware", "tariff" or your competitor's name in 8-K / 10-K / 10-Q filings, with SIC and state facets.
• Insider-trading feed — Form 3/4/5 filings per issuer (forms: ["4"]), newest first, with direct XML/HTML links.
• 13F holdings tracking — 13F-HR filings for a list of institutional managers (by CIK) each quarter.
• IPO / capital-markets pipeline — S-1, S-1/A, 424B4 and F-1 filings with since to see who is going public.
• Proxy-season and governance research — DEF 14A / DEFA14A / PRE 14A by ticker; former names, filer category, addresses via includeCompanyProfile.
• Due diligence — full history of a company (paged back to 1994) filtered by form and date range.

Input

Field	Type	Default	Notes
mode	submissions | fullTextSearch	submissions	submissions = filings of specific companies. fullTextSearch = search filing text market-wide (needs query).
tickers	string[]	["AAPL"]	Exchange tickers (AAPL, BRK-B/BRK.B) or CIKs (up to 10 digits). Resolved via company_tickers.json; funds, insiders and private issuers have no ticker — use the CIK. Unknown values yield an error item.
companyNameContains	string[]	—	Name fragments matched against SEC company titles. Exact title wins; otherwise first match is used and the alternatives are logged as a warning.
includeCompanyProfile	boolean	false	Emit one company item per company (former names, addresses, EIN, filer category, SIC, exchanges, FYE…).
forms	string[]	["10-K","10-Q","8-K"]	Free-text form filter. Aliases are normalized (10k→10-K, def14a→DEF 14A, 13F→13F-HR, 10-KA→10-K/A). Empty = all.
formTypes	string[] (multi-select)	—	Same as forms, picked from the 88-entry dictionary below; merged with forms.
since	YYYY-MM-DD	—	Filed on/after. Older submission pages are fetched automatically when the range needs them.
until	YYYY-MM-DD	—	Filed on/before.
itemCodes	string[] (multi-select)	—	Submissions mode: keep 8-K / 8-K/A that report at least one of these items (dictionary below). Ignored in full-text mode.
limitPerCompany	integer 1–1000	20	Newest-first cap per company, after filters.
query	string	—	Full-text mode only, required. "exact phrase", words are ANDed, OR, -exclude, cyber* wildcards.
startDate / endDate	YYYY-MM-DD	fall back to since/until	Full-text date window. Empty = 2001 → today.
entityName	string	—	Full-text: filer name contains (EFTS entityName).
sics	string[]	—	Full-text: 4-digit SIC codes of the filer.
locationCodes	string[]	—	Full-text: US state or EDGAR country codes of the filer.
locationType	located | incorporated	located	Whether locationCodes mean business address or state of incorporation.
maxItems	integer 1–10000	200	Hard cap on all dataset items (filings + company + error items).
fields	string[]	—	Whitelist of output fields; type, id, error are always kept.
dedupe	boolean	true	One item per accession number (co-registrants, several matching documents).

Nothing is required: tickers or companyNameContains in submissions mode, query in full-text mode. Bad dates, an empty query or an unknown mode fail fast with a clear error.

Reference

Form types (forms / formTypes)

Any EDGAR form string is accepted in forms; the ones below are in the multi-select and get a formTitle in the output. Full official list: EDGAR form types.

Form	Title
3	Initial statement of insider beneficial ownership
4	Insider transaction report (2 business days)
5	Annual insider ownership statement
144	Notice of proposed sale of restricted securities
10-K	Annual report (US domestic)
10-K/A	Annual report amendment
10-KT	Transition annual report
10-Q	Quarterly report
10-Q/A	Quarterly report amendment
8-K	Current report (material events)
8-K/A	Current report amendment
20-F	Annual report (foreign private issuer)
20-F/A	Foreign annual report amendment
40-F	Annual report (Canadian issuer, MJDS)
6-K	Report of foreign private issuer
10-D	Asset-backed issuer distribution report
11-K	Employee stock plan annual report
NT 10-K	Notification of late 10-K
NT 10-Q	Notification of late 10-Q
NT 20-F	Notification of late 20-F
ARS	Annual report to security holders
S-1	IPO / general registration statement
S-1/A	S-1 amendment
S-3	Shelf registration (seasoned issuer)
S-3/A	S-3 amendment
S-3ASR	Automatic shelf registration (WKSI)
S-4	Registration for M&A / exchange offers
S-4/A	S-4 amendment
S-8	Employee benefit plan registration
S-11	Real estate company registration
F-1	Foreign issuer IPO registration
F-1/A	F-1 amendment
F-3	Foreign issuer shelf registration
F-4	Foreign issuer M&A registration
F-10	Canadian issuer registration (MJDS)
424B1	Prospectus (new facts, Rule 424(b)(1))
424B2	Prospectus (pricing supplement)
424B3	Prospectus (substantive changes)
424B4	Final IPO prospectus
424B5	Prospectus supplement (shelf takedown)
424B7	Prospectus (selling security holder info)
FWP	Free writing prospectus
DEF 14A	Definitive proxy statement
DEFA14A	Additional definitive proxy soliciting materials
DEFM14A	Definitive merger proxy statement
PRE 14A	Preliminary proxy statement
PREM14A	Preliminary merger proxy statement
DEF 14C	Definitive information statement
PX14A6G	Exempt shareholder solicitation notice
13F-HR	Institutional holdings report (quarterly)
13F-HR/A	13F-HR amendment
13F-NT	13F notice (holdings reported by another manager)
SC 13D	Beneficial ownership >5% (active)
SC 13D/A	SC 13D amendment
SC 13G	Beneficial ownership >5% (passive)
SC 13G/A	SC 13G amendment
SC TO-T	Third-party tender offer statement
SC TO-I	Issuer tender offer statement
SC 14D9	Tender offer solicitation/recommendation
SC 13E3	Going-private transaction statement
3/A	Form 3 amendment
4/A	Form 4 amendment
D	Notice of exempt offering (Reg D private placement)
D/A	Form D amendment
C	Regulation Crowdfunding offering statement
C/A	Form C amendment
C-U	Crowdfunding progress update
C-AR	Crowdfunding annual report
1-A	Regulation A offering statement
1-K	Regulation A annual report
1-SA	Regulation A semiannual report
N-CSR	Certified shareholder report (funds)
N-CSRS	Semiannual certified shareholder report (funds)
N-PORT	Monthly portfolio holdings (funds)
N-PX	Proxy voting record (funds)
N-1A	Open-end fund registration
N-2	Closed-end fund registration
485BPOS	Post-effective amendment (funds)
497K	Summary prospectus (funds)
X-17A-5	Broker-dealer annual audited report
ABS15G	Asset-backed securities report
CORRESP	Correspondence with SEC staff
UPLOAD	SEC staff comment letter
EFFECT	Notice of effectiveness
REGDEX	Regulation D exemption (legacy)
IRANNOTICE	Iran-related disclosure notice
SD	Specialized disclosure (conflict minerals)
PX14A6N	Exempt solicitation (non-management)

8-K item codes (itemCodes, output items8k)

Item	Title
1.01	Entry into a Material Definitive Agreement
1.02	Termination of a Material Definitive Agreement
1.03	Bankruptcy or Receivership
1.04	Mine Safety — Reporting of Shutdowns and Patterns of Violations
1.05	Material Cybersecurity Incidents
2.01	Completion of Acquisition or Disposition of Assets
2.02	Results of Operations and Financial Condition
2.03	Creation of a Direct Financial Obligation or Off-Balance Sheet Arrangement
2.04	Triggering Events That Accelerate or Increase a Direct Financial Obligation
2.05	Costs Associated with Exit or Disposal Activities
2.06	Material Impairments
3.01	Notice of Delisting or Failure to Satisfy a Continued Listing Rule
3.02	Unregistered Sales of Equity Securities
3.03	Material Modification to Rights of Security Holders
4.01	Changes in Registrant’s Certifying Accountant
4.02	Non-Reliance on Previously Issued Financial Statements (Restatement)
5.01	Changes in Control of Registrant
5.02	Departure/Election of Directors or Officers; Compensatory Arrangements
5.03	Amendments to Articles of Incorporation or Bylaws; Change in Fiscal Year
5.04	Temporary Suspension of Trading Under Employee Benefit Plans
5.05	Amendments to or Waiver of Code of Ethics
5.06	Change in Shell Company Status
5.07	Submission of Matters to a Vote of Security Holders
5.08	Shareholder Director Nominations
6.01	ABS Informational and Computational Material
6.02	Change of Servicer or Trustee
6.03	Change in Credit Enhancement or Other External Support
6.04	Failure to Make a Required Distribution
6.05	Securities Act Updating Disclosure
6.06	Static Pool
7.01	Regulation FD Disclosure
8.01	Other Events
9.01	Financial Statements and Exhibits

Where the data comes from

Source	Used for
https://www.sec.gov/files/company_tickers.json	ticker / name → CIK
https://data.sec.gov/submissions/CIK##########.json (+ -submissions-NNN.json pages)	company profile and full filing history
https://efts.sec.gov/LATEST/search-index	full-text search (same API the EDGAR full-text search UI uses)

Examples

Watchlist 8-K monitor — executive changes, restatements, cyber incidents this quarter

{ "tickers": ["AAPL", "MSFT", "NVDA", "JPM"], "forms": ["8-K", "8-K/A"], "itemCodes": ["1.05", "4.02", "5.02"], "since": "2026-07-01", "limitPerCompany": 20 }

Who disclosed a cybersecurity incident since June (market-wide)

{ "mode": "fullTextSearch", "query": "\"cybersecurity incident\"", "forms": ["8-K"], "startDate": "2026-06-01", "maxItems": 100 }

Material weakness in annual reports of California software companies

{ "mode": "fullTextSearch", "query": "\"material weakness\"", "forms": ["10-K"], "sics": ["7372"], "locationCodes": ["CA"], "startDate": "2026-01-01", "maxItems": 200 }

Insider Form 4 feed for one issuer, compact output

{ "tickers": ["TSLA"], "forms": ["4"], "since": "2026-08-01", "limitPerCompany": 100, "fields": ["ticker", "form", "filingDate", "reportDate", "documentUrl"] }

13F holdings of Berkshire and a private manager by CIK, plus profiles

{ "tickers": ["BRK-B", "1067983", "1350694"], "formTypes": ["13F-HR", "13F-HR/A"], "limitPerCompany": 4, "includeCompanyProfile": true }

Ten years of annual reports (auto-pages into older history)

{ "companyNameContains": ["Palantir Technologies"], "tickers": ["AAPL"], "forms": ["10-K"], "since": "2014-01-01", "until": "2024-12-31", "limitPerCompany": 15 }

Output

One item per filing (type: "filing"), optionally company items, error items for unresolved companies, and in full-text mode one searchSummary item first (total hits + top facets by form, entity, SIC, state).

Submissions-mode filing (trimmed):

{
  "type": "filing",
  "id": "0000320193-26-000018",
  "ticker": "AAPL",
  "cik": "0000320193",
  "companyName": "Apple Inc.",
  "sic": "3571",
  "sicDescription": "Electronic Computers",
  "stateOfIncorporation": "CA",
  "fiscalYearEnd": "0926",
  "exchanges": ["Nasdaq"],
  "form": "8-K",
  "formTitle": "8-K — Current report (material events)",
  "filingDate": "2026-07-30",
  "reportDate": "2026-07-30",
  "acceptedAt": "2026-07-30T20:30:28.000Z",
  "accessionNumber": "0000320193-26-000018",
  "act": "34",
  "fileNumber": "001-36743",
  "filmNumber": "261223821",
  "items8k": ["2.02", "9.01"],
  "items8kTitles": ["Results of Operations and Financial Condition", "Financial Statements and Exhibits"],
  "size": 417360,
  "isXBRL": true,
  "isInlineXBRL": true,
  "primaryDocument": "aapl-20260730.htm",
  "primaryDocDescription": "8-K",
  "documentUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/aapl-20260730.htm",
  "indexUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/0000320193-26-000018-index.html",
  "folderUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/",
  "filingIndexJsonUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/index.json",
  "txtUrl": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/0000320193-26-000018.txt",
  "viewerUrl": "https://www.sec.gov/cgi-bin/viewer?action=view&cik=320193&accession_number=0000320193-26-000018&xbrl_type=v",
  "inlineViewerUrl": "https://www.sec.gov/ix?doc=/Archives/edgar/data/320193/000032019326000018/aapl-20260730.htm",
  "sourceUrl": "https://data.sec.gov/submissions/CIK0000320193.json",
  "fetchedAt": "2026-09-12T23:34:42.039Z"
}

Field	Meaning
type, id	filing / company / error / searchSummary; id = accession number for filings, company:<cik> for profiles
ticker, cik, companyName	issuer; cik is always 10 digits
sic, sicDescription, stateOfIncorporation, fiscalYearEnd (MMDD), exchanges	issuer profile snapshot
form, formTitle	EDGAR form and human title (null for forms outside the dictionary)
filingDate, reportDate, acceptedAt	filed date, period of report, EDGAR acceptance timestamp
accessionNumber, act, fileNumber, filmNumber, size	EDGAR identifiers; act = 33/34; size in bytes
items8k, items8kTitles	8-K item codes and titles (empty for other forms)
isXBRL, isInlineXBRL	structured-data flags
primaryDocument, primaryDocDescription, documentUrl	main document of the filing
indexUrl, folderUrl, filingIndexJsonUrl, txtUrl	filing index page, raw folder, machine-readable folder listing, complete submission text file
viewerUrl (XBRL), inlineViewerUrl (inline XBRL)	SEC interactive viewers
sourceUrl, fetchedAt	exact API URL the item came from, ISO timestamp

Full-text hits additionally carry filers[] (all co-filers with name/ticker/CIK), rootForm, sics, businessStates, businessLocations, incorporationStates, matchedDocument, matchedDocumentType, matchedDocumentDescription and score; documentUrl points at the matched document (not necessarily the primary one).

Company profile items: tickers, exchanges, entityType, category (filer status), ownerOrg, ein, lei, phone, website, investorWebsite, addresses.{business,mailing}, formerNames[], totalFilingsIndexed, edgarUrl.

Use it from code / agents

Apify API (curl):

curl -X POST "https://api.apify.com/v2/acts/yadroo~sec-edgar-filings/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tickers":["AAPL","MSFT"],"forms":["8-K"],"since":"2026-01-01","limitPerCompany":5}'

JavaScript (apify-client):

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('yadroo/sec-edgar-filings').call({
    mode: 'fullTextSearch', query: '"cybersecurity incident"', forms: ['8-K'], startDate: '2026-06-01', maxItems: 50,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();

Python (apify-client):

from apify_client import ApifyClient
client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("yadroo/sec-edgar-filings").call(run_input={
    "tickers": ["TSLA"], "forms": ["4"], "since": "2026-08-01", "limitPerCompany": 100})
items = client.dataset(run["defaultDatasetId"]).list_items().items

MCP: add https://mcp.apify.com to your agent (Claude, Cursor, custom) and call the yadroo/sec-edgar-filings tool with the same JSON input — the input schema descriptions are written for agents.

Pricing

Pay per event: $0.001 per run start + $0.002 per dataset item (filings, company profiles, error and summary items all count). Typical runs: 4 tickers × 5 latest 8-Ks = 20 items ≈ $0.041; a 100-hit full-text search ≈ $0.20; a 1,000-filing history dump ≈ $2.00. Set maxItems to bound the cost.

Limits & FAQ

• Rate limits. SEC fair use is 10 requests/second; the actor sends a descriptive User-Agent, sleeps ≥150 ms between requests, retries 429/5xx three times with backoff and fails with a clear error instead of looping.
• Freshness. data.sec.gov submissions update within minutes of EDGAR acceptance; full-text search indexes filings with a short delay and covers 2001 onward.
• Tickers. Only exchange-listed issuers are in the ticker map. Mutual funds, insiders, 13F managers and private issuers must be given as CIK (find it on EDGAR company search).
• Paging into history. The first submissions file holds the newest ~1,000 filings; older pages are fetched only when since/until/limitPerCompany need them.
• Full-text search availability. efts.sec.gov can occasionally answer 403 Forbidden or throttle bursts (SEC fair use: under 10 requests per second). The actor then stops with an explicit error; submissions mode is unaffected. EFTS caps paging at 10,000 documents per query — narrow the date range for more.
• itemCodes apply to 8-K/8-K/A in submissions mode only (EFTS has no item filter — put "Item 1.05" in the query instead).
• No document text. The actor returns metadata and links; pair it with a fetch tool or the Yadroo sec-company-financials actor for XBRL numbers.
• Roadmap. Exhibit lists from index.json, Form 4 transaction parsing, 13F holdings tables. Tell us what you need.

---

Made by Yadroo · Related actors: sec-company-financials · us-treasury-yields · fx-rates · world-bank-indicators · sanctions-screen · domain-intel · google-news-search