GETPopular/v1/calendar/earnings

Earnings Calendar

Retrieve earnings calendar for a specific date. Accepts YYYY-MM-DD or the strings today, yesterday, tomorrow (resolved in New York time).

Historical access

Free plans can access the most recent 24 months of historical data. Pro plans can access all available history.

Request

GET https://api.earningsapi.com/v1/calendar/earnings?date=2026-01-31&apikey=YOUR_API_KEY
RequestPython
import requests

response = requests.get("https://api.earningsapi.com/v1/calendar/earnings?date=2026-01-31", params={"apikey": "YOUR_API_KEY"}, timeout=30)
response.raise_for_status()
print(response.json())

Query parameters

NameTypeRequiredDescription
datestringYesDate in YYYY-MM-DD (e.g. "2026-01-31"), or the strings "today", "yesterday", "tomorrow" (resolved in New York time)

Response fields

FieldTypeDescription
datestringDate in YYYY-MM-DD format
prearrayCompanies reporting before market open
afterarrayCompanies reporting after market close
notSuppliedarrayCompanies with unspecified reporting times

Response example

JSON response
{
  "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
    }
  ]
}

Quota and limits

Compare plan limits and historical data access.

Free

  • 60 requests / minute
  • 100 requests / day
  • 1,000 requests / month
  • The most recent 24 months of historical data on supported endpoints

Pro

  • 300 requests / minute
  • Unlimited daily requests
  • Unlimited monthly requests
  • All available history on supported endpoints

Free daily and monthly quotas reset in New York time. Historical access applies to endpoints marked Historical access.

View usage and plans