Insider Holdings

GET

/stocks/insiders/vX/holdings

This endpoint is free to use during the early-access beta period. Features may change or move to different plans later.

Retrieve the roster of a company's insiders and the shares each one currently holds — one row per reporting owner per issuer. Each record identifies a director, officer, or 10%+ shareholder with their roles, officer title, first and latest filing dates, filing count, and direct and indirect share holdings plus ownership percentage, synthesized from all of that owner's SEC Form 3, 4, and 5 filings. Unlike the Form 3 and Form 4 endpoints, which return individual filings as submitted, this endpoint returns one consolidated, current ownership position per insider — use each owner's owner_cik to follow their complete filing history across companies through the Form 3, 4, and 5 endpoints.

Use Cases: Identifying who a company's insiders are, measuring insider ownership stakes and concentration, looking up a director or officer's CIK, and tracking an insider's holdings across multiple companies.

Stocks BasicFree

Stocks Starter$29/mo

Stocks Developer$79/mo

Stocks Advanced$199/mo

Stocks BasicFree

Stocks Starter$29/mo

Stocks Developer$79/mo

Stocks Advanced$199/mo

Plan AccessIncluded in all Stocks plans

Stocks BasicFree

Updated daily

Stocks Starter$29/mo

Updated daily

Stocks Developer$79/mo

Updated daily

Stocks Advanced$199/mo

Updated daily

Stocks BasicFree

Updated daily

Stocks Starter$29/mo

Updated daily

Stocks Developer$79/mo

Updated daily

Stocks Advanced$199/mo

Updated daily

Plan RecencyUpdated daily

Plan HistoryNot applicable to this endpoint

Query Parameters

tickers

string

Filter for arrays that contain the value.

issuer_cik

string

SEC Central Index Key of the issuer company (10 digits, zero-padded).

owner_cik

string

SEC Central Index Key of the reporting owner (10 digits, zero-padded). Stable across issuers and years; use it to follow a person through the Form 3, 4, and 5 endpoints.

last_filing_date

string

Date of the owner's most recent Form 3, 4, or 5 filing for this issuer (formatted as YYYY-MM-DD). Value must be formatted 'yyyy-mm-dd'.

limit

integer

Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '10000'.

sort

string

A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'last_filing_date' if not specified. The sort order defaults to 'desc' if not specified.

Response Attributes

next_url

string

optional

If present, this value can be used to fetch the next page.

request_id

string

A request id assigned by the server.

results

array (object)

The results for this request.

filing_count

integer

Number of Form 3, 4, and 5 filings by the owner for this issuer.

first_filing_date

string

optional

Date of the owner's first Form 3, 4, or 5 filing for this issuer (formatted as YYYY-MM-DD). Filings begin in 2003.

issuer_cik

string

optional

SEC Central Index Key of the issuer company (10 digits, zero-padded).

issuer_name

string

optional

Name of the issuer company as reported in the most recent filing.

last_filing_date

string

optional

Date of the owner's most recent Form 3, 4, or 5 filing for this issuer (formatted as YYYY-MM-DD).

officer_title

string

optional

Title of the officer in the most recent filing, if the reporting owner is an officer.

oldest_position_date

string

optional

Earliest as_of_date among the summed positions (formatted as YYYY-MM-DD). A date far behind last_filing_date means at least one position has not been restated recently and may be stale.

owner_cik

string

optional

SEC Central Index Key of the reporting owner (10 digits, zero-padded). Stable across issuers and years; use it to follow a person through the Form 3, 4, and 5 endpoints.

owner_name

string

optional

Name of the reporting owner (individual or entity) as reported in the most recent filing.

ownership_pct

number

optional

shares_owned as a percentage of the issuer's shares outstanding (largest share class) as of last_filing_date. Absent when shares outstanding is not available for the issuer.

position_count

integer

optional

Number of positions summed into shares_owned: one for direct holdings plus one per indirect vehicle.

roles

array (string)

optional

Relationships of the reporting owner to the issuer in the most recent filing. Possible values: director, officer, ten_percent_owner, other.

shares_owned

number

optional

Shares of the issuer's non-derivative securities the owner holds: the sum of the latest reported balance of each position (direct, and each indirect vehicle) across their Form 3, 4, and 5 filings. As filed, not adjusted for splits. Unexercised options and other derivative securities are not included. Absent when the owner has never reported a share balance.

shares_owned_direct

number

optional

Shares held directly, in the owner's own name.

shares_owned_indirect

number

optional

Shares held indirectly through trusts, LLCs, family members, and other vehicles.

tickers

array (string)

optional

Ticker symbols of the issuer as of the owner's most recent filing. Multiple symbols may indicate different share classes.

status

enum (OK)

The status of this request's response.

Code Examples

curl -X GET "https://api.massive.com/stocks/insiders/vX/holdings?limit=100&sort=last_filing_date.desc&apiKey=YOUR_API_KEY"

Query URL

GET

https://api.massive.com/stocks/insiders/vX/holdings?apiKey=YOUR_API_KEY

Run query unavailable

Create account or sign in to Massive

Scroll to see updated query response

Response Object

{
  "count": 1,
  "next_url": "https://api.massive.com/stocks/insiders/vX/holdings?cursor=eyJsaW1pd...",
  "request_id": "047c7035a86042b1925118e5f68d81b0",
  "results": [
    {
      "filing_count": 94,
      "first_filing_date": "2013-10-09",
      "issuer_cik": "0001045810",
      "issuer_name": "NVIDIA CORP",
      "last_filing_date": "2026-09-18",
      "officer_title": "EVP & Chief Financial Officer",
      "oldest_position_date": "2021-09-15",
      "owner_cik": "0001588670",
      "owner_name": "Kress Colette",
      "ownership_pct": 0.0198,
      "position_count": 11,
      "roles": [
        "officer"
      ],
      "shares_owned": 4776533,
      "shares_owned_direct": 765103,
      "shares_owned_indirect": 4011430,
      "tickers": [
        "NVDA"
      ]
    }
  ],
  "status": "OK"
}

// Run a query to see a response

{ "count": 1, "next_url": "https://api.massive.com/stocks/insiders/vX/holdings?cursor=eyJsaW1pd...", "request_id": "047c7035a86042b1925118e5f68d81b0", "results": [ { "filing_count": 94, "first_filing_date": "2013-10-09", "issuer_cik": "0001045810", "issuer_name": "NVIDIA CORP", "last_filing_date": "2026-09-18", "officer_title": "EVP & Chief Financial Officer", "oldest_position_date": "2021-09-15", "owner_cik": "0001588670", "owner_name": "Kress Colette", "ownership_pct": 0.0198, "position_count": 11, "roles": [ "officer" ], "shares_owned": 4776533, "shares_owned_direct": 765103, "shares_owned_indirect": 4011430, "tickers": [ "NVDA" ] } ], "status": "OK" }