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.
Also known as: earnings dates, earnings schedule, reporting date.
Earnings Calendar in Python
get_earnings_calendar is part of the Toolkit module of the open-source Finance Toolkit. Install it with:
pip install financetoolkit -U
Then call get_earnings_calendar as shown below.
from financetoolkit import Toolkit
toolkit = Toolkit(
["AAPL", "MSFT", "GOOGL", "AMZN"], api_key="FINANCIAL_MODELING_PREP_KEY", start_date="2022-08-01", quarterly=False
)
earning_calendar = toolkit.get_earnings_calendar()
earning_calendar.loc['AMZN']
Which returns:
| date | EPS | Estimated EPS | Revenue | Estimated Revenue | Last Updated |
|---|---|---|---|---|---|
| 2022-10-27 00:00:00 | 0.2 | 0.22 | 1.27101e+11 | 1.27308e+11 | 2025-04-25 |
| 2023-02-02 00:00:00 | 0.21 | 0.15 | 1.49204e+11 | 1.45713e+11 | 2025-04-25 |
| 2023-04-27 00:00:00 | 0.31 | 0.21 | 1.27358e+11 | 1.24551e+11 | 2025-04-25 |
| 2023-08-03 00:00:00 | 0.65 | 0.35 | 1.34383e+11 | 1.19573e+11 | 2025-04-25 |
| 2023-10-26 00:00:00 | 0.94 | 0.58 | 1.43083e+11 | 1.33393e+11 | 2025-04-25 |
| 2024-02-01 00:00:00 | 1 | 0.8 | 1.69961e+11 | 1.66172e+11 | 2025-04-25 |
| 2024-04-30 00:00:00 | 0.98 | 0.83 | 1.43313e+11 | 1.42654e+11 | 2025-04-25 |
| 2024-08-01 00:00:00 | 1.26 | 1.03 | 1.47977e+11 | 1.48665e+11 | 2025-04-25 |
| 2024-10-31 00:00:00 | 1.43 | 1.14 | 1.58877e+11 | 1.57275e+11 | 2025-04-25 |
| 2025-02-06 00:00:00 | 1.86 | 1.49 | 1.87792e+11 | 1.87337e+11 | 2025-05-06 |
| 2025-05-01 00:00:00 | 1.59 | 1.37 | 1.55667e+11 | 1.55148e+11 | 2025-08-01 |
| 2025-07-31 00:00:00 | 1.68 | 1.31 | 1.67702e+11 | 1.61776e+11 | 2025-09-30 |
Parameters
get_earnings_calendar accepts the following parameters:
- actual_dates (bool): Defines whether to return the actual dates or the corresponding quarters.
- overwrite (bool): Defines whether to overwrite the existing data.
- 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.
- rounding (int | None): The number of decimals to round the results to. Defaults to None, which uses the rounding set on the Toolkit.