Skip to main content
GET
/
earnings
Get earnings snapshot
curl --request GET \
  --url https://api.financialdatasets.ai/earnings \
  --header 'X-API-KEY: <api-key>'
{
  "earnings": {
    "ticker": "<string>",
    "report_period": "2023-12-25",
    "fiscal_period": "<string>",
    "currency": "<string>",
    "quarterly": {
      "fiscal_period": "<string>",
      "currency": "<string>",
      "revenue": 123,
      "estimated_revenue": 123,
      "revenue_surprise": "BEAT",
      "earnings_per_share": 123,
      "estimated_earnings_per_share": 123,
      "eps_surprise": "BEAT",
      "net_income": 123,
      "gross_profit": 123,
      "operating_income": 123,
      "weighted_average_shares": 123,
      "weighted_average_shares_diluted": 123,
      "cash_and_equivalents": 123,
      "total_debt": 123,
      "total_assets": 123,
      "total_liabilities": 123,
      "shareholders_equity": 123,
      "net_cash_flow_from_operations": 123,
      "capital_expenditure": 123,
      "net_cash_flow_from_investing": 123,
      "net_cash_flow_from_financing": 123,
      "change_in_cash_and_equivalents": 123,
      "free_cash_flow": 123,
      "revenue_chg": 123,
      "net_income_chg": 123,
      "operating_income_chg": 123,
      "gross_profit_chg": 123,
      "net_cash_flow_from_operations_chg": 123,
      "net_cash_flow_from_investing_chg": 123,
      "net_cash_flow_from_financing_chg": 123,
      "free_cash_flow_chg": 123
    },
    "annual": {
      "fiscal_period": "<string>",
      "currency": "<string>",
      "revenue": 123,
      "estimated_revenue": 123,
      "revenue_surprise": "BEAT",
      "earnings_per_share": 123,
      "estimated_earnings_per_share": 123,
      "eps_surprise": "BEAT",
      "net_income": 123,
      "gross_profit": 123,
      "operating_income": 123,
      "weighted_average_shares": 123,
      "weighted_average_shares_diluted": 123,
      "cash_and_equivalents": 123,
      "total_debt": 123,
      "total_assets": 123,
      "total_liabilities": 123,
      "shareholders_equity": 123,
      "net_cash_flow_from_operations": 123,
      "capital_expenditure": 123,
      "net_cash_flow_from_investing": 123,
      "net_cash_flow_from_financing": 123,
      "change_in_cash_and_equivalents": 123,
      "free_cash_flow": 123,
      "revenue_chg": 123,
      "net_income_chg": 123,
      "operating_income_chg": 123,
      "gross_profit_chg": 123,
      "net_cash_flow_from_operations_chg": 123,
      "net_cash_flow_from_investing_chg": 123,
      "net_cash_flow_from_financing_chg": 123,
      "free_cash_flow_chg": 123
    }
  }
}

​
Overview

The Earnings Feed returns the most recent earnings filings across all covered companies, sorted by SEC filing date (newest first). Use it to power dashboards, alerts, or any view of “what just got reported.” Each entry includes the same per-company shape as the Company Earnings endpoint:
  • Key income statement fields (e.g. revenue, net income, EPS)
  • Key balance sheet fields (e.g. cash, debt, assets, liabilities)
  • Key cash flow fields (e.g. operating cash flow, capex, free cash flow)
  • Analyst estimate comparisons when available (e.g. estimated revenue / EPS and BEAT/MISS/MEET)
  • The SEC filing identity: source (8-K, 10-Q, 10-K, 20-F), filing_url, accession_number, and filing_date
The feed deduplicates by (ticker, report_period) so each earnings event appears once. As a company progresses from its initial 8-K earnings release to the full 10-Q or 10-K filing, the entry updates to reflect the most complete data available.

​
Getting Started

Call GET /earnings/ without the ticker query param:
  1. Add your API key to the header of the request as X-API-KEY.
  2. Optionally provide limit (default 10, max 100).
  3. Execute the API request.

​
Example

Earnings Feed
import requests

headers = {
    "X-API-KEY": "your_api_key_here"
}

# Top 10 most recently filed earnings across all companies
url = "https://api.financialdatasets.ai/earnings/"

response = requests.get(url, headers=headers)
data = response.json()
feed = data["earnings"]
To request more items per page: 
url = "https://api.financialdatasets.ai/earnings/?limit=50"

​
Example Response

{
  "earnings": [
    {
      "ticker": "NFLX",
      "report_period": "2026-03-31",
      "filing_date": "2026-04-17",
      "fiscal_period": "2026-Q1",
      "currency": "USD",
      "quarterly": {
        "source": "10-Q",
        "filing_url": "https://www.sec.gov/Archives/edgar/data/1065280/000106528026000138/nflx-20260331.htm",
        "accession_number": "0001065280-26-000138",
        "revenue": 12249757000.0,
        "estimated_revenue": 12145873572,
        "revenue_surprise": "BEAT",
        "earnings_per_share": 1.23,
        "estimated_earnings_per_share": 0.76,
        "eps_surprise": "BEAT",
        "net_income": 5282791000.0,
        "gross_profit": 6361519000.0,
        "operating_income": 3956997000.0,
        "weighted_average_shares": 4222787000.0,
        "weighted_average_shares_diluted": 4298437000.0,
        "cash_and_equivalents": 12259772000.0,
        "total_debt": 14360516000.0,
        "total_assets": 61015914000.0,
        "total_liabilities": 29889515000.0,
        "shareholders_equity": 31126399000.0,
        "free_cash_flow": 5094075000.0
      }
    }
  ]
}

​
Query Parameters

ParameterTypeDefaultDescription
limitinteger10Number of items to return. Clamped to the range [1, 100]. Invalid values fall back to the default.

​
Notes

  • Sort order: items are returned newest-first by SEC filing_date.
  • Dedup: each (ticker, report_period) appears once per response. When both an 8-K earnings release and the corresponding 10-Q/10-K are available, the more complete filing is shown.
  • Source field: identifies the underlying SEC form — 8-K (preliminary earnings release), 10-Q (quarterly), 10-K (annual), or 20-F (foreign annual).
  • Polling: results are cached briefly server-side; expect near-real-time freshness as new filings land.
  • Per-item shape matches Company Earnings, so the same parsing logic works for both endpoints.

Authorizations

​
X-API-KEY
string
header
required

API key for authentication.

Query Parameters

​
ticker
string
required

The ticker symbol.

Response

Earnings response

​
earnings
object