/v2/earningsCompany Earnings
Retrieve historical and upcoming earnings events for a single symbol.
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/earnings?symbol=AAPL&apikey=YOUR_API_KEYimport requests
response = requests.get("https://api.earningsapi.com/v2/earnings?symbol=AAPL", params={"apikey": "YOUR_API_KEY"}, timeout=30)
response.raise_for_status()
print(response.json())Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Yes | Stock ticker symbol (e.g., "AAPL") |
Response fields
| Field | Type | Description |
|---|---|---|
date | string | Earnings date in YYYY-MM-DD format |
symbol | string | Stock ticker symbol (e.g., "AAPL") |
name | string | null | Company name, or null when not available |
time | string | null | Reporting session: time-pre-market, time-after-hours, or null when unavailable. |
epsEstimate | number | null | Estimated EPS per share (numeric, e.g., 1.73) or null if not available |
eps | number | null | Reported EPS per share; may be updated. Null when unavailable. |
revenue | number | null | Reported revenue amount, unscaled; may be updated. Null when unavailable. |
revenueEstimate | number | null | Estimated revenue amount, unscaled, or null when unavailable. |
Response example
[
{
"date": "2026-11-02",
"symbol": "AAPL",
"name": "Apple Inc.",
"time": "time-after-hours",
"epsEstimate": 1.983514,
"eps": 2.05,
"revenue": 114477000000,
"revenueEstimate": 113378166980
},
{
"date": "2026-07-30",
"symbol": "AAPL",
"name": "Apple Inc.",
"time": "time-after-hours",
"epsEstimate": 1.889297,
"eps": 2.02,
"revenue": 109417000000,
"revenueEstimate": 108962934623
}
]