All Expected Earnings Dates

All Expected Earnings Dates Web API Documentation

Returns expected earnings announcement dates for all companies, optionally filtered by tickers. Results are always sorted by expected date ascending and include company identification.

Endpoint:
https://api-v2.intrinio.com/companies/upcoming_earnings

Parameters

Name Description Example
tickers
Comma-delimited list of tickers to filter results AAPL,MSFT,GOOGL
fiscal_year
Filter by fiscal year 2024
fiscal_period
Filter by fiscal period (Q1, Q2, Q3, FY) Q1
expected_date_after
Returns expected dates on or after this date. Defaults to today if not provided. 2024-01-01
expected_date_before
Returns expected dates before this date. 2024-12-31
page_size
The number of results to return 100
next_page
Gets the next page of data from a previous API call ~null
tickers
* required
Comma-delimited list of tickers to filter results
fiscal_year
* required
Filter by fiscal year
fiscal_period
* required
Filter by fiscal period (Q1, Q2, Q3, FY)
expected_date_after
* required
Returns expected dates on or after this date. Defaults to today if not provided.
expected_date_before
* required
Returns expected dates before this date.
page_size
* required
The number of results to return
next_page
* required
Gets the next page of data from a previous API call

Output Fields

Name Description Type
expected_earnings_dates
array
company_id
The Intrinio ID for the company string
ticker
The ticker symbol of the company string
fiscal_year
The fiscal year for the earnings report integer
fiscal_period
The fiscal period for the earnings report (Q1, Q2, Q3, Q4, or FY) string
expected_date
The expected date of the earnings announcement date
expected_8k_at
The expected timestamp when the 8-K filing will be available string
historically_earliest
The earliest date (MM-DD format) this company has historically announced earnings for this fiscal period string
historically_latest
The latest date (MM-DD format) this company has historically announced earnings for this fiscal period string
next_page The token for the next page of results string
expected_earnings_dates
next_page
The token for the next page of results