v3

latestOpenAPI 3.1.02026-07-26490368.4 KB

Ownership

Get insider holders for a company

Returns insider holders with their security and vehicle holdings.

get/v1/company/ownership/insider/holders

Query parameters

apiKeystring

API Key (alternatively send via X-Api-Key header)

tickerstring

Company ticker, use with mic or alone for US tickers

Example:MSFT

Company ticker, use with mic or alone for US tickers

micCodestring

Company MIC, use with ticker

Example:XNAS

Company MIC, use with ticker

exchangestring

Company exchange code, use with ticker

Example:NASDAQ

Company exchange code, use with ticker

companyKeystring

Company key (alternative to ticker/micCode/exchange)

Example:NASDAQ_MSFT

Company key (alternative to ticker/micCode/exchange)

cusipstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

Example:594918104

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP

isinstring

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

Example:US5949181045

Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN

figistring

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

Example:BBG000BPH459

FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.

cikstring

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

Example:789019

Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.

fsclstring

Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.

Example:FSCLC6CGT4DXS597

Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.

includeInactiveboolean

Set to true to include insiders who are no longer actively affiliated with the company. Defaults to excluding them.

pageNumberinteger

Page number (1-indexed)

Example:1

Page number (1-indexed)

pageSizeinteger

Number of records per page, max 1000

Example:1000

Number of records per page, max 1000

Response

Insider holders

Example response

{
  "pagination": {
    "page": 1,
    "pageSize": 1000,
    "totalCount": 142,
    "totalPages": 1
  },
  "data": [
    {
      "holderId": "9df95a60-4b3a-41f7-8dc1-4042f935ce95",
      "holderName": "Tim Cook",
      "cik": "1214156",
      "title": "Chief Executive Officer",
      "relationship": [
        "officer"
      ],
      "isActive": true,
      "sharesHeldTotal": 3280180,
      "valueTotal": 614847000,
      "percentOfSharesOutstanding": 0.42,
      "currency": "USD",
      "holdings": [
        {
          "securityName": "Common Stock",
          "ownershipVehicle": "Family Trust",
          "sharesHeld": 125000,
          "filingDate": "2025-04-15",
          "value": 24500000,
          "percentOfSharesOutstanding": 0.31,
          "sources": [
            {
              "document": "https://api.fiscal.ai/v1/company/ownership/filing/0000320193-25-000073/pdf?companyKey=NASDAQ_AAPL",
              "pageNumber": 84
            }
          ]
        }
      ]
    }
  ]
}