--- title: "Get earnings snapshot" method: GET path: "/earnings" tags: ["Earnings"] --- # Get earnings snapshot `GET /earnings` Get the most recent earnings snapshot for a ticker. Optional change fields are returned only when available. ## Query parameters - `ticker` string, required - `limit` integer ## Response `200` Earnings response - EarningsResponse - `earnings` EarningsRecord[] — Flat list of SEC filings for the ticker, sorted by (report_period DESC, filing_date ASC). When `limit=N`, up to N report_periods worth of filings are returned; entry count may exceed N when a recent period has both an 8-K and a 10-Q/10-K. - `ticker` string, required — The requested ticker symbol. - `report_period` string, date, required — Report period this filing covers. - `fiscal_period` string — Fiscal period label (e.g. 2026-Q1 or 2025-FY). - `currency` string — ISO currency code (e.g. USD). - `source_type` '8-K' | '10-Q' | '10-K' | '20-F', required — The SEC form type backing this filing. - `filing_date` string, date, required — Calendar day SEC accepted the filing, in Eastern Time (the SEC's operating timezone). Calendar-day pair to `filing_datetime`. - `filing_datetime` string, date-time, nullable — Sub-day timestamp recording when SEC accepted the filing, in Eastern Time. Sourced from SEC's `acceptanceDateTime` field on the EDGAR submissions API. Pairs with `filing_date` (calendar-day precision of the same event). - `filing_window` 'PRE_MARKET' | 'DURING_MARKET' | 'AFTER_HOURS' | 'WEEKEND', nullable — Market session at the moment SEC accepted the filing, evaluated in Eastern Time. PRE_MARKET = weekday 04:00–09:30 ET. DURING_MARKET = weekday 09:30–16:00 ET. AFTER_HOURS = weekday outside regular trading hours. WEEKEND = Saturday or Sunday. Null when filing_datetime is unavailable. - `signals` Signal[] — Curated, market-moving insights distilled from this filing. Each item has a pre-rendered `headline`, structured `details`, and an `importance` ranking. Returned only when at least one signal fires for this entry; field is omitted otherwise. Capped at 8 per entry, ordered HIGH → MEDIUM → LOW. - `type` 'MARGIN_EXPANSION' | 'MARGIN_CONTRACTION' | 'GUIDANCE_RAISED' | 'GUIDANCE_LOWERED' | 'GUIDANCE_REAFFIRMED' | 'GUIDANCE_INITIATED' | 'SEGMENT_OUTPERFORMANCE' | 'SEGMENT_UNDERPERFORMANCE' | 'NON_GAAP_DIVERGENCE' | 'BACKLOG_SURGE' | 'BACKLOG_DECLINE' | 'REVENUE_INCREASE' | 'REVENUE_DECLINE' | 'STRONG_REVENUE_INCREASE' | 'STRONG_REVENUE_DECLINE' | 'NET_INCOME_INCREASE' | 'NET_INCOME_DECLINE' | 'STRONG_NET_INCOME_INCREASE' | 'STRONG_NET_INCOME_DECLINE' | 'EPS_INCREASE' | 'EPS_DECLINE' | 'STRONG_EPS_INCREASE' | 'STRONG_EPS_DECLINE' | 'CAPEX_INCREASE' | 'CAPEX_DECLINE' | 'STRONG_CAPEX_INCREASE' | 'STRONG_CAPEX_DECLINE', required — Signal category. MARGIN_EXPANSION/MARGIN_CONTRACTION: any of gross/operating/net margin moved year-over-year by ≥100bps. GUIDANCE_RAISED/GUIDANCE_LOWERED/GUIDANCE_REAFFIRMED/GUIDANCE_INITIATED: forward-looking guidance change reported in the filing. SEGMENT_OUTPERFORMANCE/SEGMENT_UNDERPERFORMANCE: best- or worst-performing reportable segment by organic revenue growth. NON_GAAP_DIVERGENCE: an adjusted/non-GAAP figure differs materially from its GAAP counterpart on the same period. BACKLOG_SURGE/BACKLOG_DECLINE: backlog or remaining performance obligations moved year-over-year by ≥20%. REVENUE_INCREASE/STRONG_REVENUE_INCREASE and DECLINE variants: tiered year-over-year revenue change (≥10% / ≥20% magnitude). NET_INCOME_INCREASE/STRONG_NET_INCOME_INCREASE and DECLINE variants: tiered year-over-year net income change (≥15% / ≥30%). EPS_INCREASE/STRONG_EPS_INCREASE and DECLINE variants: tiered year-over-year EPS change (≥15% / ≥30%); independent from net income because share buybacks can amplify EPS movement. CAPEX_INCREASE/STRONG_CAPEX_INCREASE and DECLINE variants: tiered year-over-year capital expenditure change in spending magnitude (≥15% / ≥30%). - `metric` string, nullable — The metric this signal references, when applicable (e.g. `revenue`, `earnings_per_share`, `operating_margin`, or a guidance/KPI metric name). - `period` string, nullable — The fiscal period the signal references (e.g. `2026-Q1`, `FY 2026`). Forward guidance signals reference the guided period; financial signals reference the reporting period of this filing. - `headline` string, required — Pre-rendered, human-readable summary suitable for direct display. - `details` object — Structured fields specific to the signal type. Contents vary: guidance signals carry `low`, `high`, `point_estimate`, `prior_value`, `revision_pct`; segment signals carry `best`, `worst`, `spread_pp`; non-GAAP signals carry `gaap_field`, `non_gaap_value`, `gaap_value`, `divergence_pct`; growth signals carry `current`, `yoy_chg`. Null values are omitted. Refer to type-specific examples. - `filing_url` string, uri, required — URL to the SEC filing. - `accession_number` string, required — SEC accession number identifying the filing. - `quarterly` EarningsTimeDimension - `revenue` number, nullable - `revenue_chg` number — Percentage change in revenue versus the prior period as a decimal (e.g. 0.10 = +10%). Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable. - `revenue_yoy_chg` number — Year-over-year change in revenue versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `earnings_per_share` number, nullable - `earnings_per_share_chg` number — Percentage change in EPS versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable. - `earnings_per_share_yoy_chg` number — Year-over-year change in EPS versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `gross_profit` number, nullable - `gross_profit_chg` number — Percentage change in gross profit versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable. - `gross_profit_yoy_chg` number — Year-over-year change in gross profit versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `gross_margin` number — Gross margin as a decimal (gross_profit / revenue). Returned only when calculable. - `gross_margin_chg_bps` number — Absolute change in gross margin versus the prior period in basis points (e.g. 200.0 = margin expanded 200 bps). Returned only when calculable. - `gross_margin_chg_pct` number — Percentage change in gross margin versus the prior period as a decimal. Returned only when calculable. - `gross_margin_yoy_chg_bps` number — Year-over-year change in gross margin versus the same fiscal quarter one year prior, in basis points. Quarterly payload only. Returned only when calculable. - `gross_margin_yoy_chg_pct` number — Year-over-year percentage change in gross margin versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `operating_income` number, nullable - `operating_income_chg` number — Percentage change in operating income versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable. - `operating_income_yoy_chg` number — Year-over-year change in operating income versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `operating_margin` number — Operating margin as a decimal (operating_income / revenue). Returned only when calculable. - `operating_margin_chg_bps` number — Absolute change in operating margin versus the prior period in basis points. Returned only when calculable. - `operating_margin_chg_pct` number — Percentage change in operating margin versus the prior period as a decimal. Returned only when calculable. - `operating_margin_yoy_chg_bps` number — Year-over-year change in operating margin versus the same fiscal quarter one year prior, in basis points. Quarterly payload only. Returned only when calculable. - `operating_margin_yoy_chg_pct` number — Year-over-year percentage change in operating margin versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `net_income` number, nullable - `net_income_chg` number — Percentage change in net income versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable. - `net_income_yoy_chg` number — Year-over-year change in net income versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `net_margin` number — Net margin as a decimal (net_income / revenue). Returned only when calculable. - `net_margin_chg_bps` number — Absolute change in net margin versus the prior period in basis points. Returned only when calculable. - `net_margin_chg_pct` number — Percentage change in net margin versus the prior period as a decimal. Returned only when calculable. - `net_margin_yoy_chg_bps` number — Year-over-year change in net margin versus the same fiscal quarter one year prior, in basis points. Quarterly payload only. Returned only when calculable. - `net_margin_yoy_chg_pct` number — Year-over-year percentage change in net margin versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `weighted_average_shares` number, nullable - `weighted_average_shares_diluted` number, nullable - `cash_and_equivalents` number, nullable - `change_in_cash_and_equivalents` number, nullable - `total_debt` number, nullable - `total_assets` number, nullable - `total_liabilities` number, nullable - `shareholders_equity` number, nullable - `net_cash_flow_from_operations` number, nullable - `net_cash_flow_from_operations_chg` number — Percentage change in net cash flow from operations versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable. - `net_cash_flow_from_operations_yoy_chg` number — Year-over-year change in net cash flow from operations versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `net_cash_flow_from_investing` number, nullable - `net_cash_flow_from_investing_chg` number — Percentage change in net cash flow from investing versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable. - `net_cash_flow_from_investing_yoy_chg` number — Year-over-year change in net cash flow from investing versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `net_cash_flow_from_financing` number, nullable - `net_cash_flow_from_financing_chg` number — Percentage change in net cash flow from financing versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable. - `net_cash_flow_from_financing_yoy_chg` number — Year-over-year change in net cash flow from financing versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `capital_expenditure` number, nullable - `capital_expenditure_chg` number — Percentage change in capital expenditure versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable. - `capital_expenditure_yoy_chg` number — Year-over-year change in capital expenditure versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `free_cash_flow` number, nullable - `free_cash_flow_chg` number — Percentage change in free cash flow versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable. - `free_cash_flow_yoy_chg` number — Year-over-year change in free cash flow versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `annual` EarningsTimeDimension - `revenue` number, nullable - `revenue_chg` number — Percentage change in revenue versus the prior period as a decimal (e.g. 0.10 = +10%). Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable. - `revenue_yoy_chg` number — Year-over-year change in revenue versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `earnings_per_share` number, nullable - `earnings_per_share_chg` number — Percentage change in EPS versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable. - `earnings_per_share_yoy_chg` number — Year-over-year change in EPS versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `gross_profit` number, nullable - `gross_profit_chg` number — Percentage change in gross profit versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable. - `gross_profit_yoy_chg` number — Year-over-year change in gross profit versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `gross_margin` number — Gross margin as a decimal (gross_profit / revenue). Returned only when calculable. - `gross_margin_chg_bps` number — Absolute change in gross margin versus the prior period in basis points (e.g. 200.0 = margin expanded 200 bps). Returned only when calculable. - `gross_margin_chg_pct` number — Percentage change in gross margin versus the prior period as a decimal. Returned only when calculable. - `gross_margin_yoy_chg_bps` number — Year-over-year change in gross margin versus the same fiscal quarter one year prior, in basis points. Quarterly payload only. Returned only when calculable. - `gross_margin_yoy_chg_pct` number — Year-over-year percentage change in gross margin versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `operating_income` number, nullable - `operating_income_chg` number — Percentage change in operating income versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable. - `operating_income_yoy_chg` number — Year-over-year change in operating income versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `operating_margin` number — Operating margin as a decimal (operating_income / revenue). Returned only when calculable. - `operating_margin_chg_bps` number — Absolute change in operating margin versus the prior period in basis points. Returned only when calculable. - `operating_margin_chg_pct` number — Percentage change in operating margin versus the prior period as a decimal. Returned only when calculable. - `operating_margin_yoy_chg_bps` number — Year-over-year change in operating margin versus the same fiscal quarter one year prior, in basis points. Quarterly payload only. Returned only when calculable. - `operating_margin_yoy_chg_pct` number — Year-over-year percentage change in operating margin versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `net_income` number, nullable - `net_income_chg` number — Percentage change in net income versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable. - `net_income_yoy_chg` number — Year-over-year change in net income versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `net_margin` number — Net margin as a decimal (net_income / revenue). Returned only when calculable. - `net_margin_chg_bps` number — Absolute change in net margin versus the prior period in basis points. Returned only when calculable. - `net_margin_chg_pct` number — Percentage change in net margin versus the prior period as a decimal. Returned only when calculable. - `net_margin_yoy_chg_bps` number — Year-over-year change in net margin versus the same fiscal quarter one year prior, in basis points. Quarterly payload only. Returned only when calculable. - `net_margin_yoy_chg_pct` number — Year-over-year percentage change in net margin versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `weighted_average_shares` number, nullable - `weighted_average_shares_diluted` number, nullable - `cash_and_equivalents` number, nullable - `change_in_cash_and_equivalents` number, nullable - `total_debt` number, nullable - `total_assets` number, nullable - `total_liabilities` number, nullable - `shareholders_equity` number, nullable - `net_cash_flow_from_operations` number, nullable - `net_cash_flow_from_operations_chg` number — Percentage change in net cash flow from operations versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable. - `net_cash_flow_from_operations_yoy_chg` number — Year-over-year change in net cash flow from operations versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `net_cash_flow_from_investing` number, nullable - `net_cash_flow_from_investing_chg` number — Percentage change in net cash flow from investing versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable. - `net_cash_flow_from_investing_yoy_chg` number — Year-over-year change in net cash flow from investing versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `net_cash_flow_from_financing` number, nullable - `net_cash_flow_from_financing_chg` number — Percentage change in net cash flow from financing versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable. - `net_cash_flow_from_financing_yoy_chg` number — Year-over-year change in net cash flow from financing versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `capital_expenditure` number, nullable - `capital_expenditure_chg` number — Percentage change in capital expenditure versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable. - `capital_expenditure_yoy_chg` number — Year-over-year change in capital expenditure versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. - `free_cash_flow` number, nullable - `free_cash_flow_chg` number — Percentage change in free cash flow versus the prior period as a decimal. Sequential in the quarterly payload, year-over-year in the annual payload. Returned only when calculable. - `free_cash_flow_yoy_chg` number — Year-over-year change in free cash flow versus the same fiscal quarter one year prior, as a decimal. Quarterly payload only. Returned only when calculable. ## Other responses - `400` — Bad request - `401` — Unauthorized - `402` — The request requires a paid subscription - `404` — The specified resource was not found --- [API](https://skmtc.net/financialdatasets/apis/financial-datasets-api.md) · [All operations](https://skmtc.net/financialdatasets/apis/financial-datasets-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/financialdatasets/financial-datasets-api/revisions/df2363101891/schema)