Dashboard

Earnings calendar

GET/api/earnings/calendar

Stock Pro

Upcoming earnings dates and analyst consensus for up to 50 symbols in a single request. Each symbol maps to its next earnings date, expected report time, and consensus EPS estimate. Delisted companies (no active listing on any exchange) map to null.

Get API key Try it live in the API explorer

Query parameters

Example request

curl 'https://api.stockfit.io/v1/api/earnings/calendar?symbols=AAPL%2CMSFT%2CGOOGL' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Map of symbols to upcoming earnings dates and estimates

Response schema

  • * (additional properties) object
    • earningsDate string | null

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

    • filingDate string | null

      Projected date the SEC filing (10-Q/10-K) becomes available (YYYY-MM-DD), or null if unknown

    • filingType string (enum)

      Filing type for the upcoming report

      Allowed values: 10-Q, 10-K
    • epsEstimate number

      Analyst consensus EPS estimate for the upcoming report. Absent when unavailable.

    • numEstimates integer

      Number of analyst estimates behind epsEstimate. Absent unless epsEstimate is present.

    • reportTime string (enum)

      Expected time of day for the report. Absent when not supplied.

      Allowed values: pre_market, after_hours

Example response

{
  "AAPL": {
    "earningsDate": "2026-04-24",
    "filingDate": "2026-05-01",
    "filingType": "10-Q",
    "epsEstimate": 1.23,
    "numEstimates": 12,
    "reportTime": "after_hours"
  },
  "MSFT": {
    "earningsDate": "2026-04-22",
    "filingDate": "2026-04-28",
    "filingType": "10-Q"
  }
}

400 Bad Request

Invalid parameters

Response schema

  • error string

    Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

  • error string

    Human-readable error message

Example response

{}