FIfiscal
Ownership

Get insider holders for a company

Changed on

Returns insider holders with per-account holdings: ownership type (direct/indirect), security class, and derivative positions held as a share class, marked by derivativeKind. The holder's sharesHeldTotal, valueTotal and percentOfSharesOutstanding include those positions.

get/v1/company/ownership/insider/holders

Request

  • Base URL
    https://api.fiscal.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.fiscal.ai/v1/company/ownership/insider/holders
  • Auth
    API key in query parameter apiKey

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
micCodestring

Company MIC, use with ticker

Example:XNAS
exchangestring

Company exchange code, use with ticker

Example:NASDAQ
companyKeystring

Company key (alternative to ticker/micCode/exchange)

Example:NASDAQ_MSFT
cusipstring

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

Example:594918104
isinstring

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

Example:US5949181045
figistring

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

Example:BBG000BPH459
cikstring

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

Example:789019
fsclstring

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

Example:FSCLC6CGT4DXS597
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). page is accepted as an alias when pageNumber is absent.

Example:1
pageSizeinteger

Number of records per page, max 1000

Example: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",
          "securityType": "common",
          "ownershipVehicle": "Family Trust",
          "ownershipType": "direct",
          "derivativeKind": "held_share_class",
          "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
            }
          ]
        }
      ]
    }
  ]
}

Changes

  • 87e4d680032cRevision changes
    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the required property //// to the response with the status