Earnings Calendar
Obtain Earnings Calendars for any range of companies. You have the option to obtain the actual dates or to convert to the corresponding quarters.
Note that this information requires a Premium FMP subscription.
The surprise is the reported EPS against the estimate, usually as a percentage of the estimate. Most companies report above the consensus, so a small beat is the norm, and the share price tends to react to the size of the surprise, to revenue against its estimate and to the guidance given on the call rather than to a beat as such.
Also known as: earnings dates, earnings schedule, reporting date.
Earnings Calendar in Python or via the MCP
Install the Finance Toolkit with:
pip install financetoolkit -U
Then call get_earnings_calendar as shown below.
from financetoolkit import Toolkit
toolkit = Toolkit(
["COST"],
api_key="FINANCIAL_MODELING_PREP_KEY",
start_date="2024-01-01",
end_date="2025-12-31",
)
toolkit.get_earnings_calendar(show_columns=["EPS", "Estimated EPS"])
Or, after setting up the Finance Toolkit MCP, ask:
How did Costco's reported earnings per share compare with analysts' estimates in each quarterly report of 2024 and 2025?
Which returns:
| date | EPS | Estimated EPS |
|---|---|---|
| 2024-03-07 00:00:00 | 3.92 | 3.62 |
| 2024-05-30 00:00:00 | 3.78 | 3.7 |
| 2024-09-26 00:00:00 | 5.29 | 5.08 |
| 2024-12-12 00:00:00 | 4.04 | 3.79 |
| 2025-03-06 00:00:00 | 4.02 | 4.09 |
| 2025-05-29 00:00:00 | 4.28 | 4.24 |
| 2025-09-25 00:00:00 | 5.87 | 5.8 |
| 2025-12-11 00:00:00 | 4.5 | 4.27 |
Parameters
get_earnings_calendar accepts the following parameters.
| Parameter | Type | Description | Example |
|---|---|---|---|
actual_dates | bool | Defines whether to return the actual dates or the corresponding quarters. Defaults to True. | False |
overwrite | bool | Defines whether to overwrite the existing data. Defaults to False. | True |
show_columns | list[str] | None | A list of column names to keep in the result. Invalid names are reported and ignored. Defaults to None, which keeps every column. | ["EPS", "Estimated EPS"] |
rounding | int | None | The number of decimals to round the results to. Defaults to None, which uses the rounding set on the Toolkit. | 2 |