// API V1

EarningsDeck API

The EarningsDeck API gives programmatic access to the same clean, structured investor-relations data that powers the platform: company profiles, SEC filings, parsed insider transactions, structured financial statements, earnings materials, and a forward-looking events calendar — for the US public-company universe.

It is a REST API that returns JSON over HTTPS. Every endpoint is a GET. All monetary values in financial responses are in millions of USD unless a unit field says otherwise.

// BASE URL

Base URL

All endpoints are relative to:

https://earningsdeck.xyz/api/v1

// AUTH

Authentication

Authenticate every request with your API key in the x-api-key header. Generate a key from your subscription dashboard — it is shown only once at creation, so store it securely.

curl https://earningsdeck.xyz/api/v1/financials?ticker=AAPL \
  -H "x-api-key: ed_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Keys are prefixed ed_live_ (paid) or ed_test_ (free tier). Missing key → 401; invalid/expired → 403.

// LIMITS

Rate limits & plans

Limits reset at midnight UTC. Exceeding your limit returns 429 with an upgrade URL.

Plan	Price	Requests / day	Access
Free	$0	100 / day	/financials only
Pro	$49 / mo	1,000 / day	All endpoints
Enterprise	$199 / mo	Unlimited	All endpoints + redistribution rights

// RESPONSE

Response format

Responses are JSON. Financial data is grouped into income statements, balance sheets, and cash-flow statements. Example — GET /financials?ticker=AAPL&period=annual:

{
  "ticker": "AAPL",
  "company": "Apple Inc.",
  "currency": "USD",
  "unit": "millions",
  "financials": {
    "income_statements": [{
      "period": "FY 2025",
      "form_type": "10-K",
      "revenue": 416161,
      "gross_profit": 195201,
      "operating_income": 133050,
      "net_income": 112010,
      "earnings_per_share_diluted": 7.46,
      "net_margin": 0.2692
    }],
    "balance_sheets": [{ "period": "FY 2025", "total_assets": 359241, "total_equity": 73733 }],
    "cash_flow_statements": [{ "period": "FY 2025", "operating_cash_flow": 118254, "free_cash_flow": 108807 }]
  }
}

// ENDPOINTS

Endpoints

GET/api/v1/companiesList covered companies (paginated).

GET/api/v1/companies/{ticker}Company profile: exchange, sector, IR links.

GET/api/v1/companies/search?q=Search companies by ticker or name.

GET/api/v1/earnings?ticker=Earnings events and materials for a company.

GET/api/v1/earnings/{ticker}Earnings grouped by fiscal quarter.

GET/api/v1/earnings/calendarUpcoming earnings calendar across companies.

GET/api/v1/events?ticker=All corporate events for a company.

GET/api/v1/events/{ticker}Events for a single company.

GET/api/v1/financials?ticker=Structured income / balance / cash-flow statements.

GET/api/v1/filings?ticker=SEC filings (10-K, 10-Q, 8-K, Form 4, DEF 14A…).

GET/api/v1/insider/{ticker}Parsed Form 4 insider transactions.

GET/api/v1/press-releases/{ticker}Press releases for a company.

GET/api/v1/search?q=Full-text search across filings and documents.

On the free tier only /financials is accessible; all other endpoints require Pro or Enterprise.

Questions? hello@earningsdeck.xyz·Get an API key