/v2/calendar/earningsEarnings Calendar
Retrieve earnings events for a specific date. Accepts YYYY-MM-DD, today, yesterday, or tomorrow (New York time).
Historical access
Free plans can access the most recent 24 months of historical data. Pro plans can access all available history.
Available earnings history starts at 2018-01-01, subject to your plan’s historical access. Reported results may be updated as new information becomes available. Unavailable values are null. Applies to epsEstimate, revenueEstimate, eps, and revenue. Free updates values once daily for events dated today or later. Pro updates values every 5 minutes. Today is determined in America/New_York at request time, using each event's official date. Earlier events return the same latest available values on both plans, subject to historical access limits. Event schedules remain available; values not yet available in the Free daily update are null, not zero. This difference applies only to the fields listed here, not all API data.
Request
GET https://api.earningsapi.com/v2/calendar/earnings?date=2026-10-29&apikey=YOUR_API_KEYimport requests
response = requests.get("https://api.earningsapi.com/v2/calendar/earnings?date=2026-10-29", params={"apikey": "YOUR_API_KEY"}, timeout=30)
response.raise_for_status()
print(response.json())Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
date | string | Yes | Date in YYYY-MM-DD (e.g. "2026-01-31"), or the strings "today", "yesterday", "tomorrow" (resolved in New York time) |
Response 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 |
Response example
{
"date": "2026-10-29",
"pre": [
{
"symbol": "AAMI",
"name": "Acadian Asset Management Inc.",
"epsEstimate": 1.216656,
"eps": 1.36,
"revenue": 189100000,
"revenueEstimate": 193100000
}
],
"after": [
{
"symbol": "ACCO",
"name": "Acco Brands Corporation",
"epsEstimate": 0.18751,
"eps": 0.28,
"revenue": 380300000,
"revenueEstimate": 383700000
}
],
"notSupplied": [
{
"symbol": "ABEV",
"name": "Ambev S.A.",
"epsEstimate": 0.048675,
"eps": 0.05,
"revenue": 21594600000,
"revenueEstimate": 21653103353
}
]
}