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).

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

Free tier includes 60 requests per minute, 100 requests per day, and 1,000 requests per month. Paid plans are built for production use with higher limits and a 300 requests per minute rate limit. Daily and monthly reset windows use New York time.

View usage