Footnotes

Leases

Pro

Returns the full ASC 842 lease footnote as one object per period: right-of-use asset, lease liability split (current / noncurrent / total), the undiscounted future-payment ladder, the weighted-average discount rate, cost lines, and cash paid, with operating and finance leases side by side.

Payment ladder. Filers disclose the ladder in one of two styles, mapped as follows: full-year style fills year1-year5 and thereafter; mid-fiscal-year style additionally uses remainderOfYear, the payments due in the rest of the current fiscal year, a partial year that is deliberately never merged into year1. total is the undiscounted sum as disclosed and discountExcess the imputed interest, so total − discountExcess reconciles to the discounted liability client-side.

Monetary values default to US dollars. Pass the currency parameter to receive any supported ISO 4217 currency instead: balance-sheet items convert at the period-end spot rate, cost and cash-paid flow lines at the period-average rate, and the per-period fx block records the exact rate(s) applied. Pass currency=original for as-filed values. discountRate is a fraction of 1 (0.037 = 3.7%) and never converted.

What this data can tell you:

  • Lease obligations as debt-equivalent leverage.
  • Fixed payment burden vs revenue, from the payment ladder.
  • Footprint growth or shrinkage via right-of-use assets.
  • Discount-rate changes re-marking the liability.

Data honesty notes:

  • Quarterly entries carry whatever subset the 10-Q tagged: ROU asset and liabilities nearly always; the payment ladder is 10-K-weighted. Annual cost lines are never presented as a Q4 quarter; the Q4 entry carries the year-end balance-sheet snapshot only.
  • A minority of filers mis-tag the discount rate as a whole percent (3.7); such values are re-scaled and the side is flagged normalized: true.
  • Coverage is US-GAAP (ASC 842) filers. IFRS 16 uses a different concept family and is not covered in this version.
  • operating / finance are null when the filer disclosed nothing for that side in the period.
get/api/footnotes/leases

Query parameters

symbolstring

Stock ticker symbol. Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.

cikinteger

SEC Central Index Key (CIK).

cusipstring

CUSIP identifier (9 characters).

composite_figistring

Composite OpenFIGI identifier.

share_class_figistring

Share-class OpenFIGI identifier.

currencystring

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

CodeCurrency
originalReturn every value in its original as-reported currency (no conversion)
USDUS Dollar, default
AEDUnited Arab Emirates Dirham
AFNAfghan Afghani
ALLAlbanian Lek
AMDArmenian Dram
ANGNetherlands Antillean Guilder
AOAAngolan Kwanza
ARSArgentine Peso
AUDAustralian Dollar
AWGAruban Florin
AZNAzerbaijani Manat
BAMBosnia-Herzegovina Convertible Mark
BBDBarbadian Dollar
BDTBangladeshi Taka
BGNBulgarian Lev
BHDBahraini Dinar
BIFBurundian Franc
BMDBermudan Dollar
BNDBrunei Dollar
BOBBolivian Boliviano
BRLBrazilian Real
BSDBahamian Dollar
BTNBhutanese Ngultrum
BWPBotswanan Pula
BYNBelarusian Ruble
BZDBelize Dollar
CADCanadian Dollar
CDFCongolese Franc
CHFSwiss Franc
CLPChilean Peso
CNYChinese Yuan
COPColombian Peso
CRCCosta Rican Colón
CUPCuban Peso
CVECape Verdean Escudo
CZKCzech Koruna
DJFDjiboutian Franc
DKKDanish Krone
DOPDominican Peso
DZDAlgerian Dinar
EGPEgyptian Pound
ERNEritrean Nakfa
ETBEthiopian Birr
EUREuro
FJDFijian Dollar
FKPFalkland Islands Pound
GBPBritish Pound
GELGeorgian Lari
GHSGhanaian Cedi
GIPGibraltar Pound
GMDGambian Dalasi
GNFGuinean Franc
GTQGuatemalan Quetzal
GYDGuyanaese Dollar
HKDHong Kong Dollar
HNLHonduran Lempira
HTGHaitian Gourde
HUFHungarian Forint
IDRIndonesian Rupiah
ILSIsraeli New Shekel
INRIndian Rupee
IQDIraqi Dinar
IRRIranian Rial
ISKIcelandic Króna
JMDJamaican Dollar
JODJordanian Dinar
JPYJapanese Yen
KESKenyan Shilling
KGSKyrgyz Som
KHRCambodian Riel
KMFComorian Franc
KPWNorth Korean Won
KRWSouth Korean Won
KWDKuwaiti Dinar
KYDCayman Islands Dollar
KZTKazakhstani Tenge
LAKLaotian Kip
LBPLebanese Pound
LKRSri Lankan Rupee
LRDLiberian Dollar
LSLLesotho Loti
LYDLibyan Dinar
MADMoroccan Dirham
MDLMoldovan Leu
MGAMalagasy Ariary
MKDMacedonian Denar
MMKMyanmar Kyat
MNTMongolian Tugrik
MOPMacanese Pataca
MRUMauritanian Ouguiya
MURMauritian Rupee
MVRMaldivian Rufiyaa
MWKMalawian Kwacha
MXNMexican Peso
MYRMalaysian Ringgit
MZNMozambican Metical
NADNamibian Dollar
NGNNigerian Naira
NIONicaraguan Córdoba
NOKNorwegian Krone
NPRNepalese Rupee
NZDNew Zealand Dollar
OMROmani Rial
PABPanamanian Balboa
PENPeruvian Sol
PGKPapua New Guinean Kina
PHPPhilippine Peso
PKRPakistani Rupee
PLNPolish Zloty
PYGParaguayan Guarani
QARQatari Riyal
RONRomanian Leu
RSDSerbian Dinar
RUBRussian Ruble
RWFRwandan Franc
SARSaudi Riyal
SBDSolomon Islands Dollar
SCRSeychellois Rupee
SDGSudanese Pound
SEKSwedish Krona
SGDSingapore Dollar
SHPSt. Helena Pound
SLESierra Leonean Leone
SOSSomali Shilling
SRDSurinamese Dollar
SSPSouth Sudanese Pound
STNSão Tomé & Príncipe Dobra
SVCSalvadoran Colón
SYPSyrian Pound
SZLSwazi Lilangeni
THBThai Baht
TJSTajikistani Somoni
TMTTurkmenistani Manat
TNDTunisian Dinar
TOPTongan Paʻanga
TRYTurkish Lira
TTDTrinidad & Tobago Dollar
TWDNew Taiwan Dollar
TZSTanzanian Shilling
UAHUkrainian Hryvnia
UGXUgandan Shilling
UYUUruguayan Peso
UZSUzbekistani Som
VESVenezuelan Bolívar
VNDVietnamese Dong
VUVVanuatu Vatu
WSTSamoan Tala
XAFCentral African CFA Franc
XCDEast Caribbean Dollar
XDRSpecial Drawing Rights
XOFWest African CFA Franc
XPFCFP Franc
YERYemeni Rial
ZARSouth African Rand
ZMWZambian Kwacha
ZWGZimbabwean Gold
period'annual' | 'quarter'

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 quarter-end snapshots plus the flow lines each 10-Q tagged.

limitinteger

Maximum number of periods to return (may be clamped by subscription tier).

Response

Operating and finance lease footnote data, organized by period

periodstring date

The fiscal period end date (YYYY-MM-DD)

fiscalYearinteger

The company's fiscal year (handles non-December year-ends).

fiscalPeriod'FY' | 'Q1' | 'Q2' | 'Q3' | 'Q4'

Fiscal period of a reported value: FY (annual) or Q1-Q4 (quarterly).

dateFiledstring date nullable

SEC filing acceptance date of the newest filing contributing to this period. Use this to gate point-in-time data and avoid lookahead bias.

Example response

[
  {
    "period": "2025-09-28",
    "fiscalYear": 2025,
    "fiscalPeriod": "FY",
    "operating": {
      "currency": "USD",
      "rightOfUseAsset": 9315700000,
      "liabilityCurrent": 1564500000,
      "liabilityNoncurrent": 8972200000,
      "liabilityTotal": 10536700000,
      "discountRate": 0.037,
      "payments": {
        "year1": 1940600000,
        "year2": 1757300000,
        "year3": 1548400000,
        "year4": 1360400000,
        "year5": 1190300000,
        "thereafter": 4592200000,
        "total": 12389200000,
        "discountExcess": 1852500000
      },
      "cost": {
        "operating": 2097000000
      },
      "cashPaid": 1900000000
    },
    "finance": {
      "currency": "USD"
    },
    "dateFiled": "2025-11-19",
    "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