Skip to main content
POST /v1/data/sec/beneficial-ownership/run Pricing: $0.01 per filing ($10.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
One or more US stock tickers, e.g. AAPL or BRK-B. SEC data covers US-listed companies only: non-US listings (RELIANCE.NS) and market indices (NIFTY, SENSEX) are refused with a clear error. One request reads them all.
integer
default:"365"
Lookback Days as a whole number.Min 1; max 3650.
string
default:"all"
Schedule Type to use. Both 13D and 13G by default.Allowed values: all (Both 13D and 13G), 13D (Only 13D (activist)), 13G (Only 13G (passive)).
integer
default:"0"
Min Percent as a whole number.Min 0; max 100.
integer
default:"10"
How many filings to return in total. Defaults to 10; 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 officer and director trades use sec/insider-trades; for the full filing index use sec/filings.