Ownership

Get activist stakes

Returns only the activist (Schedule 13D) subset of beneficial ownership, which is how Financial Datasets defines this route: it publishes no type parameter of its own, and this server pins type=activist regardless of any type a caller sends, so the route can never be inverted into its passive opposite. Records are the same BeneficialOwner shape /beneficial-ownership returns, but the envelope key is activist_owners, matching Financial Datasets’ ActivistOwnershipResponse. Exactly one of ticker or filer_cik is required; passing both, or neither, answers a bad_request ErrorResponse body at zero cost. filer_cik is matched only against whichever CIK-like alias a feed row happens to carry, and the verified 13D/13G item shape carries none, so a filer_cik query legitimately returns an empty list rather than a guess. history is accepted for parity but history=true answers a bad_request ErrorResponse body: these feeds carry only each stake’s latest reported state, never a full amendment chain. FRESHNESS: measured live on 2026-09-04, the newest 13D record was filed 2026-03-06, roughly six months behind. This is not a real-time feed; read each row’s own filing_date/event_date to judge recency.

GET

activist-ownership

Get activist stakes

curl --request GET \
  --url https://financialdatasets.rip/activist-ownership \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://financialdatasets.rip/activist-ownership', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://financialdatasets.rip/activist-ownership",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://financialdatasets.rip/activist-ownership"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://financialdatasets.rip/activist-ownership")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "activist_owners": [
    {
      "ticker": "AAPL",
      "reporting_person_name": "Example Activist Partners LP",
      "form_type": "SCHEDULE 13D",
      "type": "activist",
      "filing_date": "2026-03-06",
      "aggregate_amount_beneficially_owned": 52000000,
      "percent_of_class": 6.4
    }
  ]
}

Authorizations

X-API-KEY

string

header

required

The caller's own Monid API key (get one at https://monid.ai?fpr=dhruv-15136b). Passed straight through to Monid on every call, so usage bills the caller's own wallet — this is never a shared server-side credential, and the server never logs or stores it. Missing, empty, or malformed values answer 401 unauthorized before any paid call is attempted.

Query Parameters

ticker

string

Ticker of the issuer whose activist stakes to list, for example AAPL.

filer_cik

string

SEC CIK of a reporting person. See the route description: the verified feed shape carries no CIK, so this legitimately returns an empty list.

history

boolean

default:false

Accepted for Financial Datasets parameter parity. history=true answers a bad_request ErrorResponse body; only each stake's current reported state is available.

filing_date

string<date>

Restricts to stakes whose filing_date exactly equals this date (YYYY-MM-DD).

filing_date_gte

string<date>

Restricts to stakes filed on or after this date (YYYY-MM-DD).

filing_date_lte

string<date>

Restricts to stakes filed on or before this date (YYYY-MM-DD).

filing_date_gt

string<date>

Restricts to stakes filed strictly after this date (YYYY-MM-DD).

filing_date_lt

string<date>

Restricts to stakes filed strictly before this date (YYYY-MM-DD).

limit

integer

default:10

Number of records to retrieve (default: 10, max: 1000).

Required range: 1 <= x <= 1000

cursor

string

Opaque base64url pagination cursor from a previous response's next_page_url. Omit for the first page.

Response

Illustrative shape (no captured live sample committed for this route); values are structural placeholders, not a claim about real reported figures.

List envelope for /activist-ownership: {"activist_owners": [...]}. Financial Datasets keys this route differently from /beneficial-ownership even though both carry the same BeneficialOwner record, so this server does too.

activist_owners

BeneficialOwner · object[]

required

Show child attributes

next_page_url

string

Absolute URL of the next page. Present only when more records remain.

Get activist stakes

curl --request GET \
  --url https://financialdatasets.rip/activist-ownership \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://financialdatasets.rip/activist-ownership', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://financialdatasets.rip/activist-ownership",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://financialdatasets.rip/activist-ownership"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://financialdatasets.rip/activist-ownership")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "activist_owners": [
    {
      "ticker": "AAPL",
      "reporting_person_name": "Example Activist Partners LP",
      "form_type": "SCHEDULE 13D",
      "type": "activist",
      "filing_date": "2026-03-06",
      "aggregate_amount_beneficially_owned": 52000000,
      "percent_of_class": 6.4
    }
  ]
}

Financial statements

Financial metrics

Earnings

Filings

Prices

News

Insider trades

Screener

Company

KPIs

Not implemented

Macroeconomics

Index funds

Institutional holdings

Ownership

Get activist stakes

Authorizations

Query Parameters

Response