Dashboard

Compensation

GET/api/executives/compensation

Stock Pro

Returns historical CEO and officer compensation alongside Total Shareholder Return (TSR) comparison, extracted from the SEC-mandated pay-versus-performance table in DEF 14A proxy statements.

Compensation fields explained:

Field Description
ceoTotalComp CEO total compensation as reported in the Summary Compensation Table — includes salary, bonus, stock awards (grant-date fair value), option awards, non-equity incentive plan compensation, pension value changes, and all other compensation
ceoActuallyPaidComp SEC-mandated "Compensation Actually Paid" (CAP) metric, introduced in 2022 — adjusts total compensation for actual changes in equity award values during the year, rather than using grant-date fair value. This better reflects what executives actually received
avgOfficerTotalComp Average total compensation for non-CEO Named Executive Officers (NEOs)
avgOfficerActuallyPaidComp Average CAP for non-CEO NEOs

TSR fields explained:

Total Shareholder Return is indexed to $100 at the start of the measurement period. A value of 178.45 means a $100 investment at the start would now be worth $178.45. The peer group TSR uses the company's self-selected peer group as disclosed in the proxy statement.

Data source: SEC XBRL-tagged DEF 14A filings, pay-versus-performance table.

Get API key Try it live in the API explorer

Query parameters

Example request

curl 'https://api.stockfit.io/v1/api/executives/compensation?symbol=AAPL&cik=320193&cusip=037833100&composite_figi=BBG000B9XRY4&share_class_figi=BBG001S5N8V8' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Annual compensation and TSR data

Response schema

array of:
  • fiscalYear integer
  • ceoTotalComp number | null

    CEO total compensation (Summary Compensation Table)

  • ceoActuallyPaidComp number | null

    CEO Compensation Actually Paid (equity-adjusted)

  • avgOfficerTotalComp number | null

    Average non-CEO NEO total compensation

  • avgOfficerActuallyPaidComp number | null

    Average non-CEO NEO Compensation Actually Paid

  • companyTsr number | null

    Company Total Shareholder Return (indexed to $100)

  • peerGroupTsr number | null

    Peer group TSR (indexed to $100, company-selected peer group)

Example response

[
  {
    "fiscalYear": 2024,
    "ceoTotalComp": 63208000,
    "ceoActuallyPaidComp": 74608000,
    "avgOfficerTotalComp": 27133000,
    "avgOfficerActuallyPaidComp": 31425000,
    "companyTsr": 178.45,
    "peerGroupTsr": 165.23
  }
]

400 Bad Request

Invalid parameters or company not found

Response schema

  • error string

    Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

  • error string

    Human-readable error message

Example response

{}