Calendar API

Retrieve earnings announcements for any date, grouped by reporting time. Use date=today, yesterday, or tomorrow (resolved in New York time) or a YYYY-MM-DD date.

GET /v1/calendar/earnings

Quick Copy & Paste

https://api.earningsapi.com/v1/calendar/earnings?date=2025-07-02&apikey=YOUR_API_KEY

https://api.earningsapi.com/v1/calendar/earnings?date=today&apikey=YOUR_API_KEY

Parameters

Query

Parameter	Type	Required	Description
`date`	string	Yes	YYYY-MM-DD (e.g. "2025-07-02"), or `today`, `yesterday`, `tomorrow` — resolved in New York time
`apikey`	string	Yes	Your API key

Response Example

{
  "date": "2025-07-02",
  "pre": [
    {
      "symbol": "JPM",
      "name": "J P Morgan Chase & Co",
      "epsEstimate": 5.01,
      "eps": 4.81,
      "revenue": 45798000000,
      "revenueEstimate": 46166454906
    }
  ],
  "after": [
    {
      "symbol": "DAL",
      "name": "Delta Air Lines, Inc.",
      "epsEstimate": 1.53,
      "eps": 1.85,
      "revenue": 16003000000,
      "revenueEstimate": 14682059858
    }
  ],
  "notSupplied": [
    {
      "symbol": "BK",
      "name": "The Bank Of New York Mellon Corporation ",
      "epsEstimate": 1.97,
      "eps": 1.72,
      "revenue": 8869000000,
      "revenueEstimate": 5141942072
    }
  ]
}

Response Fields

Top-level Fields

Field	Type	Description
`date`	string	Date in YYYY-MM-DD format
`pre`	array	Companies reporting before market open
`after`	array	Companies reporting after market close
`notSupplied`	array	Companies with unspecified reporting times

Company Object Fields

Field	Type	Description
`symbol`	string	Stock ticker symbol (e.g., "JPM", "AAPL")
`name`	string	Company name
`epsEstimate`	number \| null	Estimated EPS per share (numeric, e.g., 5.01) or null if not available
`eps`	number \| null	Reported EPS per share (numeric, e.g., 4.81) or null if not reported
`revenue`	number \| null	Actual revenue in dollars (e.g., 45798000000) or null if not reported
`revenueEstimate`	number \| null	Estimated revenue in dollars (e.g., 46166454906) or null if not available

cURL Example

curl "https://api.earningsapi.com/v1/calendar/earnings?date=2025-07-02&apikey=YOUR_API_KEY"

Rate Limiting

Free tier: 1,000 requests / month
429 returned when limit is exceeded