Skip to main content
POST /v1/data/sec/filings/run Pricing: $0.002 per filing ($2.00 per 1,000).

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
required
Company.
string[]
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).
boolean
default:"false"
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.
date
Date From as a date (YYYY-MM-DD).
date
Date To as a date (YYYY-MM-DD).
integer
default:"100"
How many filings to return in total. Defaults to 100; use 0 for all.

Example

Response fields

Each row in data is one filing, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For the numbers inside 10-K and 10-Q filings use sec/financials-as-reported; for Form 4 insider trades use sec/insider-trades; for 13D/13G stakes use sec/beneficial-ownership.