Pay Versus Performance API: compensation actually paid vs TSR
Pay versus performance by fiscal year from proxy XBRL: summary vs actually paid comp for the CEO and other NEOs, TSR, net income and company measure.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/pay-vs-performance?ticker=NVDA"
import os, requests
r = requests.get(
"https://secfeedapi.com/v1/pay-vs-performance",
params={'ticker': 'NVDA'},
headers={"Authorization": f"Bearer {os.environ['SECFEED_KEY']}"},
)
print(r.json())Overview
Since 2023 proxy statements include a pay versus performance table, tagged in inline XBRL with the ecd taxonomy. It compares what the CEO (PEO) and other named executives were paid, both summary and compensation actually paid, with total shareholder return, peer TSR, net income and a company selected measure.
The API reads those tags directly, one row per fiscal year, plus the list of performance measures the company considers most important and its insider trading policy and award timing disclosures.
What you get
Built for developers who would rather not parse EDGAR.
Values come from the ecd tags in the proxy's inline XBRL.
Summary compensation and compensation actually paid for both.
TSR, peer group TSR, net income and the company selected measure.
Insider trading policy and MNPI award timing disclosures.
Endpoints
Authenticate with Authorization: Bearer YOUR_KEY. Responses are JSON.
Pay versus performance by fiscal year (PEO and other NEO pay, compensation actually paid, TSR, net income, company-selected measure) plus insider-trading-policy and award-timing disclosures.
Parameters: ticker | cik, accessionNo
Response fields
The main fields in every result. The raw filing data is always one level down.
| Field | Meaning |
|---|---|
peoName, companySelectedMeasureName, measures | The CEO, the company's chosen measure and its most important measures. |
years[].fiscalYearEnd | The fiscal year of the row. |
peoSummaryCompTotal, peoCompActuallyPaid | CEO pay, summary and actually paid. |
otherNeoAvgSummaryCompTotal, otherNeoAvgCompActuallyPaid | Average for the other named executives. |
totalShareholderReturn, peerGroupTotalShareholderReturn, netIncome, companySelectedMeasure | Performance metrics. |
Use cases
- Measure pay and performance alignment
- Screen for pay that rose while TSR fell
- Research compensation actually paid trends
Datasets behind this API
The SEC forms this API reads, with live filing counts.
FAQ
What is compensation actually paid?
An SEC defined figure that adjusts summary compensation for the change in value of equity awards during the year.
Which companies have pay versus performance data?
Most companies filing proxies for fiscal years ending after December 16, 2022. Smaller reporting companies report fewer years.
Try the Pay Versus Performance free
500 API calls a month on the free plan. No sales call.