Financial Datasets

Get beneficial-ownership stakes (SEC Schedules 13D and 13G: holders of more than 5% of a class of shares), one row per reporting person. Query by ticker (who owns this company) or by filer_cik (what stakes does this filer hold); provide exactly one of the two. By default each stake's current state is returned; set history=true for the full amendment chain. Use type=activist for 13D stakes (intent to influence control) or type=passive for 13G stakes.

Changed on
get/financial-datasets/beneficial-ownership

Request

Query parameters

tickerstring

The ticker symbol of the subject company. Provide ticker or filer_cik, not both.

filer_cikstring

The SEC CIK of the filer (the beneficial owner). Provide ticker or filer_cik, not both. Use the /beneficial-ownership/filers endpoint to look up CIKs by owner name.

typestring

Filter by stake type: activist (Schedule 13D) or passive (Schedule 13G).

historyboolean

When true, returns the full amendment history of each stake instead of only its current state.

filing_datestring

Filter by exact filing date in YYYY-MM-DD format.

filing_date_gtestring

Filter by filing date greater than or equal to this date (YYYY-MM-DD).

filing_date_ltestring

Filter by filing date less than or equal to this date (YYYY-MM-DD).

filing_date_gtstring

Filter by filing date greater than this date (YYYY-MM-DD).

filing_date_ltstring

Filter by filing date less than this date (YYYY-MM-DD).

limitinteger

The total number of rows to return (default: 10; no maximum). This is the total across all pages, not a page size: each page holds up to 10 records, linked by next_page_url.

cursorstring

Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.

Response

Successful response

Changes

    • info

      added the new optional query request parameter cursor

    • info

      added the new optional query request parameter filer_cik

    • info

      added the new optional query request parameter filing_date

    • info

      added the new optional query request parameter filing_date_gt

    • info

      added the new optional query request parameter filing_date_gte

    • info

      added the new optional query request parameter filing_date_lt

    • info

      added the new optional query request parameter filing_date_lte

    • info

      added the new optional query request parameter history

    • info

      added the new optional query request parameter limit

    • info

      added the new optional query request parameter ticker

    • info

      added the new optional query request parameter type

    • info

      endpoint added