POST /v1/data/sec/filings/run
Pricing: $0.002 per filing ($2.00 per 1,000).
Request
Send the inputs underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
Which SEC forms to include. Pick one or more; any case works (10k, 10-K, sc13d). SC 13D and SC 13G also cover the newer SCHEDULE 13D/13G filings. Leave empty for all form types, amendments included.Allowed values:
10-K (10-K: Annual report), 10-Q (10-Q: Quarterly report), 8-K (8-K: Current report), S-1 (S-1: IPO registration), S-3 (S-3: Shelf registration), S-4 (S-4: Merger or exchange registration), S-8 (S-8: Employee stock plan registration), 424B (424B: Prospectus (424B1 to 424B8)), DEF 14A (DEF 14A: Proxy statement), DEFA14A (DEFA14A: Additional proxy materials), 3 (3: Initial insider ownership), 4 (4: Insider trade), 5 (5: Annual insider ownership), 144 (144: Planned insider sale), 13F-HR (13F-HR: Institutional holdings), SC 13D (SC 13D: Beneficial ownership, active (5%+)), SC 13G (SC 13G: Beneficial ownership, passive (5%+)), 20-F (20-F: Foreign issuer annual report), 6-K (6-K: Foreign issuer current report), 40-F (40-F: Canadian issuer annual report), 11-K (11-K: Employee plan annual report), NT 10-K (NT 10-K: Late annual report notice), NT 10-Q (NT 10-Q: Late quarterly report notice).Also return amended filings (10-K/A, 8-K/A, 4/A and so on) for the picked form types. Off by default; has no effect when Form Types is empty, since that already returns every form.
Example
Response fields
Each row indata is one filing, keyed by these fields.
Example response
Abridged: long text and lists are shortened.Related APIs
For the numbers inside 10-K and 10-Q filings usesec/financials-as-reported; for Form 4 insider trades use sec/insider-trades; for 13D/13G stakes use sec/beneficial-ownership.