latestOpenAPI 3.0.02026-08-2010141507.9 KB

3d5897270d8a

Earnings

Earnings snapshot

Starter Stock Pro

One-call executive summary of a company's latest annual earnings. Includes core EPS, margins, returns, cash quality, year-over-year growth, financial health scores (Piotroski F-Score, Altman Z-Score), and the next earnings/filing dates.

get/api/earnings/snapshot

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

Response

Comprehensive earnings snapshot for the latest annual period

symbolstring
periodstring

Fiscal period end date (YYYY-MM-DD)

fiscalYearinteger

The company's fiscal year (handles non-December year-ends — AAPL FY ends Sep, COST FY ends Aug).

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

Fiscal period of a reported value: FY (annual), Q1-Q4 (quarterly), or TTM (trailing twelve months).

epsnumber nullable

Basic earnings per share

epsDilutednumber nullable

Diluted earnings per share

netIncomenumber nullable

Net income in the requested currency (default USD)

revenuenumber nullable

Total revenue in the requested currency (default USD)

grossMarginnumber nullable

Gross margin as a percentage

operatingMarginnumber nullable

Operating margin as a percentage

netMarginnumber nullable

Net profit margin as a percentage

roenumber nullable

Return on equity as a percentage

roicnumber nullable

Return on invested capital as a percentage

freeCashFlownumber nullable

Free cash flow in the requested currency (default USD)

fcfToNetIncomenumber nullable

Free cash flow to net income ratio as a percentage (>100% = strong cash conversion)

revenueGrowthnumber nullable

Year-over-year revenue growth as a decimal (0.02 = 2%)

epsGrowthnumber nullable

Year-over-year EPS growth as a decimal

netIncomeGrowthnumber nullable

Year-over-year net income growth as a decimal

piotroskiFScoreinteger

Piotroski F-Score (0-9). Higher is better. Measures financial strength using 9 binary criteria covering profitability, leverage, and operating efficiency.

altmanZScorenumber nullable

Altman Z-Score for bankruptcy risk. >2.99 = safe, 1.81-2.99 = grey zone, <1.81 = distress.

altmanZone'safe' | 'grey' | 'distress'

Altman Z-Score classification: safe, grey, or distress.

nextEarningsDatestring nullable

Next earnings date (YYYY-MM-DD) or null if unknown

nextFilingDatestring nullable

Projected next SEC filing date (YYYY-MM-DD) or null if unknown

Example response

{
  "symbol": "AAPL",
  "period": "2024-09-28",
  "fiscalYear": 2025,
  "fiscalPeriod": "FY",
  "eps": 6.08,
  "epsDiluted": 6.04,
  "netIncome": 93736000000,
  "revenue": 391035000000,
  "grossMargin": 46.23,
  "operatingMargin": 31.51,
  "netMargin": 23.97,
  "roe": 127.15,
  "roic": 57.42,
  "freeCashFlow": 108807000000,
  "fcfToNetIncome": 116.09,
  "revenueGrowth": 0.0202,
  "epsGrowth": 0.1068,
  "netIncomeGrowth": 0.0843,
  "piotroskiFScore": 6,
  "altmanZScore": 5.72,
  "nextEarningsDate": "2026-04-24",
  "nextFilingDate": "2026-05-01"
}