Stock Compensation
Returns plan-level share-based compensation from the equity footnote: the award roll-forward (granted / vested / forfeited / nonvested with weighted-average grant-date fair values), SBC expense per award type, unrecognized cost, the option book (outstanding / exercisable / exercise prices), plan share reserves, and Black-Scholes assumptions. This complements the per-insider Form 3/4/5 endpoints, this is the plan, those are the people.
Two sections per period:
- awards: one entry per award type or plan the filer dimensioned (RSUs, PSUs, options, ESPP, named plans), sorted by expense.
- planTotals: the same concepts tagged without an award dimension: the whole-plan view, and the only populated section for single-plan filers that never dimension.
The roll-forward identity (prior nonvested + granted − vested − forfeited = nonvested) is checked at read time and surfaced as rollForward.reconciles (within 0.5%, present only when every leg and the prior balance are known). Values are always served as filed, never adjusted to force the identity.
Monetary values default to US dollars (currency parameter as on the statements endpoints: expense flows at the period-average rate, balances and per-share values at the period-end spot rate, fx block for the audit trail, currency=original for as-filed). Share counts are never converted.
What this data can tell you:
- Future dilution: nonvested shares and the option book vs shares outstanding.
- Committed compensation not yet expensed (unrecognized cost).
- Net share-count effect when paired with the buybacks endpoint.
- Valuation assumptions (volatility, risk-free rate, dividend yield) vs peers.
- Roll-forward consistency via the reconciles flag.
Data honesty notes:
- assumptions are fractions of 1 (0.45 = 45% volatility). Mis-tagged whole percents are re-scaled and flagged normalized: true; volatility uses a wider re-scale threshold because >150% volatility is legitimate for high-volatility issuers.
- Quarterly entries carry whatever the 10-Q tagged; full roll-forwards are 10-K-weighted.
- Coverage is US-GAAP filers; this is the widest-coverage footnote endpoint (~80% of the active universe).
Query parameters
Stock ticker symbol. Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.
SEC Central Index Key (CIK).
CUSIP identifier (9 characters).
Composite OpenFIGI identifier.
Share-class OpenFIGI identifier.
Currency to return all monetary values in (default USD).
Pass any ISO 4217 code from the table below, or original to disable conversion and receive every figure in its own as-reported currency. With a target currency, any line item not already in it is converted on the fly at the period-appropriate rate (spot for balance-sheet instants, period-average for income/cash-flow flows); values already in the target pass through untouched (no round-trip), and the per-period fx block records the rate(s) applied. A currency that cannot be priced for a given period leaves those facts native and flags them under fx.unconverted.
Accepted values
| Code | Currency |
|---|---|
| original | Return every value in its original as-reported currency (no conversion) |
| USD | US Dollar, default |
| AED | United Arab Emirates Dirham |
| AFN | Afghan Afghani |
| ALL | Albanian Lek |
| AMD | Armenian Dram |
| ANG | Netherlands Antillean Guilder |
| AOA | Angolan Kwanza |
| ARS | Argentine Peso |
| AUD | Australian Dollar |
| AWG | Aruban Florin |
| AZN | Azerbaijani Manat |
| BAM | Bosnia-Herzegovina Convertible Mark |
| BBD | Barbadian Dollar |
| BDT | Bangladeshi Taka |
| BGN | Bulgarian Lev |
| BHD | Bahraini Dinar |
| BIF | Burundian Franc |
| BMD | Bermudan Dollar |
| BND | Brunei Dollar |
| BOB | Bolivian Boliviano |
| BRL | Brazilian Real |
| BSD | Bahamian Dollar |
| BTN | Bhutanese Ngultrum |
| BWP | Botswanan Pula |
| BYN | Belarusian Ruble |
| BZD | Belize Dollar |
| CAD | Canadian Dollar |
| CDF | Congolese Franc |
| CHF | Swiss Franc |
| CLP | Chilean Peso |
| CNY | Chinese Yuan |
| COP | Colombian Peso |
| CRC | Costa Rican Colón |
| CUP | Cuban Peso |
| CVE | Cape Verdean Escudo |
| CZK | Czech Koruna |
| DJF | Djiboutian Franc |
| DKK | Danish Krone |
| DOP | Dominican Peso |
| DZD | Algerian Dinar |
| EGP | Egyptian Pound |
| ERN | Eritrean Nakfa |
| ETB | Ethiopian Birr |
| EUR | Euro |
| FJD | Fijian Dollar |
| FKP | Falkland Islands Pound |
| GBP | British Pound |
| GEL | Georgian Lari |
| GHS | Ghanaian Cedi |
| GIP | Gibraltar Pound |
| GMD | Gambian Dalasi |
| GNF | Guinean Franc |
| GTQ | Guatemalan Quetzal |
| GYD | Guyanaese Dollar |
| HKD | Hong Kong Dollar |
| HNL | Honduran Lempira |
| HTG | Haitian Gourde |
| HUF | Hungarian Forint |
| IDR | Indonesian Rupiah |
| ILS | Israeli New Shekel |
| INR | Indian Rupee |
| IQD | Iraqi Dinar |
| IRR | Iranian Rial |
| ISK | Icelandic Króna |
| JMD | Jamaican Dollar |
| JOD | Jordanian Dinar |
| JPY | Japanese Yen |
| KES | Kenyan Shilling |
| KGS | Kyrgyz Som |
| KHR | Cambodian Riel |
| KMF | Comorian Franc |
| KPW | North Korean Won |
| KRW | South Korean Won |
| KWD | Kuwaiti Dinar |
| KYD | Cayman Islands Dollar |
| KZT | Kazakhstani Tenge |
| LAK | Laotian Kip |
| LBP | Lebanese Pound |
| LKR | Sri Lankan Rupee |
| LRD | Liberian Dollar |
| LSL | Lesotho Loti |
| LYD | Libyan Dinar |
| MAD | Moroccan Dirham |
| MDL | Moldovan Leu |
| MGA | Malagasy Ariary |
| MKD | Macedonian Denar |
| MMK | Myanmar Kyat |
| MNT | Mongolian Tugrik |
| MOP | Macanese Pataca |
| MRU | Mauritanian Ouguiya |
| MUR | Mauritian Rupee |
| MVR | Maldivian Rufiyaa |
| MWK | Malawian Kwacha |
| MXN | Mexican Peso |
| MYR | Malaysian Ringgit |
| MZN | Mozambican Metical |
| NAD | Namibian Dollar |
| NGN | Nigerian Naira |
| NIO | Nicaraguan Córdoba |
| NOK | Norwegian Krone |
| NPR | Nepalese Rupee |
| NZD | New Zealand Dollar |
| OMR | Omani Rial |
| PAB | Panamanian Balboa |
| PEN | Peruvian Sol |
| PGK | Papua New Guinean Kina |
| PHP | Philippine Peso |
| PKR | Pakistani Rupee |
| PLN | Polish Zloty |
| PYG | Paraguayan Guarani |
| QAR | Qatari Riyal |
| RON | Romanian Leu |
| RSD | Serbian Dinar |
| RUB | Russian Ruble |
| RWF | Rwandan Franc |
| SAR | Saudi Riyal |
| SBD | Solomon Islands Dollar |
| SCR | Seychellois Rupee |
| SDG | Sudanese Pound |
| SEK | Swedish Krona |
| SGD | Singapore Dollar |
| SHP | St. Helena Pound |
| SLE | Sierra Leonean Leone |
| SOS | Somali Shilling |
| SRD | Surinamese Dollar |
| SSP | South Sudanese Pound |
| STN | São Tomé & Príncipe Dobra |
| SVC | Salvadoran Colón |
| SYP | Syrian Pound |
| SZL | Swazi Lilangeni |
| THB | Thai Baht |
| TJS | Tajikistani Somoni |
| TMT | Turkmenistani Manat |
| TND | Tunisian Dinar |
| TOP | Tongan Paʻanga |
| TRY | Turkish Lira |
| TTD | Trinidad & Tobago Dollar |
| TWD | New Taiwan Dollar |
| TZS | Tanzanian Shilling |
| UAH | Ukrainian Hryvnia |
| UGX | Ugandan Shilling |
| UYU | Uruguayan Peso |
| UZS | Uzbekistani Som |
| VES | Venezuelan Bolívar |
| VND | Vietnamese Dong |
| VUV | Vanuatu Vatu |
| WST | Samoan Tala |
| XAF | Central African CFA Franc |
| XCD | East Caribbean Dollar |
| XDR | Special Drawing Rights |
| XOF | West African CFA Franc |
| XPF | CFP Franc |
| YER | Yemeni Rial |
| ZAR | South African Rand |
| ZMW | Zambian Kwacha |
| ZWG | Zimbabwean Gold |
Base reporting period: annual or quarter (the periods companies actually report, without the derived ttm rollup).
The reporting period: annual returns full fiscal years; quarter returns what each 10-Q tagged (Q4 = fiscal-year-end balances).
Maximum number of periods to return (may be clamped by subscription tier).
Response
Per-award-type and plan-total share-based compensation, organized by period
Example response
[
{
"period": "2025-09-27",
"fiscalYear": 2025,
"fiscalPeriod": "FY",
"awards": [
{
"member": "us-gaap:RestrictedStockUnitsRSUMember",
"name": "Restricted Stock Units RSU",
"currency": "USD",
"expense": 8200000000,
"unrecognizedCost": 21800000000,
"rollForward": {
"granted": {
"shares": 73466000,
"waGrantDateFairValue": 226.68
},
"vested": {
"shares": 76845000,
"waGrantDateFairValue": 159.85,
"totalFairValue": 17100000000
},
"forfeited": {
"shares": 8373000,
"waGrantDateFairValue": 183.03
},
"nonvested": {
"shares": 151574000,
"waGrantDateFairValue": 189.75
},
"reconciles": true
},
"assumptions": {
"volatility": 0.45,
"riskFreeRate": 0.042,
"dividendYield": 0.006
}
}
],
"dateFiled": "2025-10-31",
"fx": {
"targetCurrency": "USD",
"originalCurrencies": [
"USD",
"EUR",
"VEF"
],
"rates": [
{
"from": "EUR",
"method": "average",
"rate": 1.0824,
"start": "2024-01-01",
"end": "2024-12-31"
},
{
"from": "EUR",
"method": "spot",
"rate": 1.0389,
"effectiveDate": "2024-12-31"
}
],
"unconverted": {
"VEF": [
"otherIncomeExpense"
]
}
}
}
]Changes
Changed in 1 of the 10 revisions of this API.1
- ○
endpoint added
endpoint-added
- ○