Skip to main content
GET
Python (SDK)

Authorizations

Authorization
string
header
required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Scopes

calendar:information

Access earnings, economic, and market schedule data

Query Parameters

from
string<date>
required

Start date in YYYY-MM-DD format. Enter the first date to include in the research window.

Example:

"2024-01-01"

to
string<date>
required

End date in YYYY-MM-DD format. Enter the last date to include in the research window.

Example:

"2024-01-31"

symbol
string

Optional stock symbol to filter results. If not provided, returns earnings for all symbols.

Example:

"AAPL"

Response

Earnings calendar data retrieved successfully

analystRating
object

Analyst ratings summary

date
string

Earnings release date

epsActual
number | null

Actual earnings per share

epsEstimate
number | null

Estimated earnings per share

epsSurprise
number | null

Difference between actual and estimated EPS

hour
string

Time of day for earnings release: 'bmo' (before market open), 'amc' (after market close), 'dmh' (during market hours)

importance
integer

Earnings event importance level (1-3, where 3 is most important). Use this to filter and prioritize high-impact earnings releases.

Required range: 1 <= x <= 3

Company logos for UI display

marketCap
number | null

Current market capitalization in millions of dollars, rounded to four decimal places. Uses the provided marketCap when available; otherwise falls back to sharesOutstanding × lastPrice. Omitted when neither source is available.

name
string

Company name

quarter
integer

Quarter number (1-4)

revenueActual
number | null

Actual revenue

revenueEstimate
number | null

Estimated revenue

revenueSurprise
number | null

Difference between actual and estimated revenue

symbol
string

Stock ticker symbol, such as AAPL. Use the exact ticker for the company you want to research.

time
string

Time of day for earnings release: '16:39:00' 24 hours format

year
integer

Year of the earnings