Calendar API

Retrieve earnings announcements for any date, grouped by reporting time.

GET /v1/calendar/{yyyy-mm-dd}

Quick Copy & Paste

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

Parameters

Path

yyyy-mm-dd — Date in ISO format (e.g. 2025-07-02)

Query

apikey — Your API key (required)

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`	string	Estimated earnings per share (e.g., "$5.01" or empty string)
`eps`	string	Actual earnings per share (e.g., "$4.81" or empty string if not reported)
`revenue`	number	Actual revenue in dollars (e.g., 45798000000) or null if not reported
`revenueEstimate`	number	Estimated revenue in dollars (e.g., 46166454906) or null if not available

cURL Example

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

Rate Limiting

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