NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

Earnings Calendar API

The Earnings Calendar API provides upcoming earnings dates and past earnings results for more than 50,000 tickers on US and international exchanges, with history going back to 2000.

Every report includes the report date, fiscal period, and actual EPS and revenue. Premium plans add consensus EPS and revenue estimates, the surprise versus those estimates, whether the company reports before or after the market, and GAAP EPS from SEC filings alongside adjusted EPS. Business plans add year-over-year growth and the stock's price reaction to each report.

Available endpoints:

Online
(4.7)

From 8,223 users

600+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
380ms422ms479ms685ms1184ms

Didn't find what you were looking for? Suggest an improvement

3 endpoints

https://api.api-ninjas.com/v1/earningscalendar

Returns a list of past earnings results and upcoming earnings dates. You can query by ticker symbol to get earnings for a specific company, by a single date, or by a date range. Up to 50 earnings results are returned per request.

Premium responses include GAAP diluted EPS from the company's SEC 10-Q or 10-K next to the adjusted EPS that analyst estimates use. Business-tier responses additionally include earnings intelligence derived from each report: EPS/revenue beat-or-miss, surprise history and beat streak, standardized unexpected earnings (SUE), year-ago EPS and revenue with year-over-year growth, the post-earnings price reaction (opening gap, 1-, 3- and 5-day moves, pre-earnings run-up, and volume), days to next earnings, and SEC 8-K–confirmed report date/time.

Parameters

At least one of ticker, date, date_start, or date_end must be provided. date cannot be combined with date_start or date_end.

  • ticker  optional

    Company ticker symbol (e.g., MSFT). If provided, returns earnings data for that specific company.

  • date  optional

    Date in YYYY-MM-DD format (e.g., 2024-01-15). If provided, returns all earnings data for that specific date.

  • date_start  optional

    Start date of a range in YYYY-MM-DD format (e.g., 2024-01-15). Inclusive. If only date_start is provided, date_end defaults to 7 days later. Cannot be combined with date.

  • date_end  optional

    End date of a range in YYYY-MM-DD format (e.g., 2024-01-22). Inclusive. Must be on or after date_start. If only date_end is provided, date_start defaults to 7 days earlier. Cannot be combined with date.

  • show_upcoming  optional Premium only

    Whether to show upcoming earnings dates. Must be either true or false. If unset, the default value is false.

  • offset  optional

    Number of results to skip for pagination. Must be a non-negative integer. Each request returns up to 50 results; use offset to page through larger result sets (e.g. offset=50 for the next 50 results).

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.

  • date

    The date of the earnings.

  • ticker

    The ticker symbol of the company.

  • fiscal_year

    The company's fiscal year for this earnings report.

  • fiscal_quarter

    The company's fiscal quarter (1-4) for this earnings report.

  • period_end_date  Premium only

    The last day of the fiscal period covered by this report (YYYY-MM-DD), from the company's SEC 10-Q or 10-K. Null for companies that don't file with the SEC and until the filing is published.

  • earnings_timing  Premium only

    Timing of the earnings call. Possible values are:

    • before_market: Earnings call occurs before the market opens.

    • during_market: Earnings call occurs during regular market hours.

    • after_market: Earnings call occurs after the market closes.

  • earnings_call_timestamp  Premium only

    Unix timestamp of when the earnings call occurred or is scheduled to occur.

  • actual_revenue

    The actual revenue, in the company's reporting currency (for example USD for US companies, JPY for Tokyo listings). Null until the company reports.

  • estimated_revenue  Premium only

    The consensus revenue estimate, in the company's reporting currency.

  • revenue_difference  Premium only

    The difference between actual and estimated revenue (actual_revenue - estimated_revenue), in the reporting currency.

  • revenue_difference_pct  Premium only

    The revenue difference as a percentage of the estimate: (actual_revenue - estimated_revenue) / |estimated_revenue| * 100. Null when estimated_revenue is 0.

  • actual_eps

    The actual earnings per share on the adjusted (non-GAAP) basis that analyst estimates use, in the company's reporting currency. See actual_eps_gaap for GAAP EPS. Null until the company reports.

  • actual_eps_gaap  Premium only

    GAAP diluted earnings per share from the company's SEC 10-Q (or 10-K for the fourth quarter), so you can compare it with the adjusted actual_eps. Available for US SEC filers once the filing is published, which is usually the report day. Fourth-quarter values are derived from the annual 10-K and can differ from the company-reported figure by a few cents.

  • estimated_eps  Premium only

    The consensus EPS estimate (adjusted basis), in the company's reporting currency.

  • eps_difference  Premium only

    The difference between actual and estimated EPS (actual_eps - estimated_eps), in the reporting currency.

  • eps_difference_pct  Premium only

    The EPS difference as a percentage of the estimate: (actual_eps - estimated_eps) / |estimated_eps| * 100. Null when estimated_eps is 0.

  • sec_filing_type  Premium only

    The SEC filing actual_eps_gaap comes from: 10-Q, or 10-K (Q4 derived from annual) for fourth quarters.

  • sec_filing_date  Premium only

    The date that SEC filing was filed (YYYY-MM-DD).

  • report_date_status  Business tier and above, or any annual plan

    confirmed once the company has filed its SEC 8-K (Item 2.02) earnings release for this report, otherwise projected. Confirmations are checked twice a day, usually the same evening for after-market reports and before the next open for pre-market reports.

  • date_confirmed  Business tier and above, or any annual plan

    true when an SEC 8-K Item 2.02 (Results of Operations) filing has been matched to this earnings report, otherwise false.

  • report_datetime  Business tier and above, or any annual plan

    The time the SEC accepted the company's 8-K earnings filing, in ISO 8601 U.S. Eastern time (e.g. 2026-07-29T16:04:53-04:00). Companies usually file it within minutes of releasing results, so it shows whether and when the report came out before or after the market. Null for projected reports and for companies that don't file 8-Ks with the SEC.

  • sec_8k_url  Business tier and above, or any annual plan

    URL of the SEC 8-K Item 2.02 filing that confirmed this report. Null when unconfirmed.

  • eps_beat_miss  Business tier and above, or any annual plan

    Whether actual EPS came in above, below, or in line with the estimate: beat, miss, or inline. Null until the company reports.

  • revenue_beat_miss  Business tier and above, or any annual plan

    Whether actual revenue came in above, below, or in line with the estimate: beat, miss, or inline. Null until the company reports.

  • eps_surprise_streak  Business tier and above, or any annual plan

    Number of consecutive most-recent quarters the company has beaten its EPS estimate (0 if the latest report missed).

  • avg_eps_surprise_pct_4q  Business tier and above, or any annual plan

    Average EPS surprise percentage over the last 4 reported quarters.

  • eps_sue  Business tier and above, or any annual plan

    Standardized Unexpected Earnings: the latest EPS surprise divided by the standard deviation of recent surprises. A normalized surprise magnitude commonly used in post-earnings-drift (PEAD) strategies.

  • year_ago_date  Business tier and above, or any annual plan

    Report date of the same quarter one year earlier.

  • year_ago_actual_eps  Business tier and above, or any annual plan

    Actual EPS (adjusted basis) reported one year earlier. Also filled for upcoming reports, so you can see what the company earned a year ago.

  • year_ago_actual_revenue  Business tier and above, or any annual plan

    Actual revenue reported one year earlier, in the reporting currency.

  • eps_growth_yoy_pct  Business tier and above, or any annual plan

    Year-over-year EPS growth in percent: (actual_eps - year_ago_actual_eps) / |year_ago_actual_eps| * 100, so a narrowing loss counts as positive growth. Null until the company reports.

  • revenue_growth_yoy_pct  Business tier and above, or any annual plan

    Year-over-year revenue growth in percent. Null until the company reports.

  • last_earnings_move_pct  Business tier and above, or any annual plan

    The one-day percentage price reaction to this earnings report, computed timing-aware (the next session for after-market reports). Null when daily prices are unavailable for the ticker.

  • avg_earnings_move_pct  Business tier and above, or any annual plan

    The average absolute one-day price move over the company's last 4 reported earnings. Useful for sizing expected moves around a print.

  • price_reaction  Business tier and above, or any annual plan

    The stock's price reaction to this report, from daily prices. The reaction session is the report date for before-market reports and the next trading day for after-market reports. Null for upcoming reports and until the reaction session has closed. Contains:

    • reaction_date: first trading session that reflects the report.

    • pre_earnings_close: close of the session before the reaction.

    • gap_pct: reaction-session open vs. the pre-earnings close, in percent.

    • move_1d_pct, move_3d_pct, move_5d_pct: close after 1, 3 and 5 sessions (counting the reaction session) vs. the pre-earnings close, in percent.

    • pre_earnings_move_5d_pct: run-up over the 5 sessions before the report, in percent.

    • volume_ratio: reaction-session volume divided by the 20-session average.

  • days_to_next_earnings  Business tier and above, or any annual plan

    Calendar days from today until the company's next scheduled earnings date.

  • next_earnings_date  Business tier and above, or any annual plan

    The company's next scheduled earnings date (YYYY-MM-DD).

  • has_transcript  Business tier and above, or any annual plan

    Whether an earnings call transcript is available for this report via the Earnings Call Transcript API.

  • surprise_history  Business tier and above, or any annual plan

    An array of up to the 4 most-recent reported quarters (most-recent first), each with date, actual_eps, estimated_eps, and eps_surprise_pct.

Note for free tier users: Premium-only fields are still included in the response, but their values are replaced with a message indicating the field requires a premium subscription. Fields marked Business, Professional, or annual subscriptions only are unlocked on the Business tier and above (or any annual plan); on lower tiers their values are likewise replaced with an upgrade message. Upgrade at /pricing to unlock real values.

Live Demo

Live demo · no API key required
Query parameters
ticker
date
date_start
date_end
show_upcoming
offset

Get a free API key to get started — no credit card required.

Headers
X-Api-KeyLog in or sign up to get your API key
GET
https://api.api-ninjas.com/v1/earningscalendar?ticker=MSFT
Sample response
[
{
"date": "2026-07-29",
"ticker": "MSFT",
"fiscal_year": 2026,
"fiscal_quarter": 4,
"period_end_date": "2026-06-30",
"earnings_timing": "after_market",
"earnings_call_timestamp": 1785360600,
"actual_revenue": 90007000000,
"estimated_revenue": 87619550000,
"revenue_difference": 2387450000,
"revenue_difference_pct": 2.7248,
"actual_eps": 4.74,
"actual_eps_gaap": 4.8,
"estimated_eps": 4.24,
"eps_difference": 0.5,
"eps_difference_pct": 11.7925,
"sec_filing_type": "10-K (Q4 derived from annual)",
"sec_filing_date": "2026-07-29",
"report_date_status": "projected",
"date_confirmed": false,
"report_datetime": null,
"sec_8k_url": null,
"eps_beat_miss": "beat",
"revenue_beat_miss": "beat",
"eps_surprise_streak": 16,
"avg_eps_surprise_pct_4q": 8.91,
"eps_sue": 3.85,
"year_ago_date": "2025-07-30",
"year_ago_actual_eps": 3.65,
"year_ago_actual_revenue": 76441000000,
"eps_growth_yoy_pct": 29.86,
"revenue_growth_yoy_pct": 17.75,
"last_earnings_move_pct": 15.51,
"avg_earnings_move_pct": 8.09,
"price_reaction": {
"reaction_date": "2026-07-30",
"pre_earnings_close": 390.54,
"gap_pct": 12.13,
"move_1d_pct": 15.51,
"move_3d_pct": 24.87,
"move_5d_pct": 24.82,
"pre_earnings_move_5d_pct": 0.05,
"volume_ratio": 3.42
},
"days_to_next_earnings": 41,
"next_earnings_date": "2026-10-28",
"has_transcript": true,
"surprise_history": [
{
"date": "2026-07-29",
"actual_eps": 4.74,
"estimated_eps": 4.24,
"eps_surprise_pct": 11.79
},
{
"date": "2026-04-29",
"actual_eps": 4.27,
"estimated_eps": 4.06,
"eps_surprise_pct": 5.17
},
{
"date": "2026-01-28",
"actual_eps": 4.14,
"estimated_eps": 3.9,
"eps_surprise_pct": 6.15
},
{
"date": "2025-10-29",
"actual_eps": 4.13,
"estimated_eps": 3.67,
"eps_surprise_pct": 12.53
}
]
},
{
"date": "2026-04-29",
"ticker": "MSFT",
"fiscal_year": 2026,
"fiscal_quarter": 3,
"period_end_date": "2026-03-31",
"earnings_timing": "after_market",
"earnings_call_timestamp": 1777435200,
"actual_revenue": 82886000000,
"estimated_revenue": 81444370000,
"revenue_difference": 1441630000,
"revenue_difference_pct": 1.7701,
"actual_eps": 4.27,
"actual_eps_gaap": 4.27,
"estimated_eps": 4.06,
"eps_difference": 0.21,
"eps_difference_pct": 5.1724,
"sec_filing_type": "10-Q",
"sec_filing_date": "2026-04-29",
"report_date_status": "projected",
"date_confirmed": false,
"report_datetime": null,
"sec_8k_url": null,
"eps_beat_miss": "beat",
"revenue_beat_miss": "beat",
"eps_surprise_streak": 15,
"avg_eps_surprise_pct_4q": 8.04,
"eps_sue": 1.7,
"year_ago_date": "2025-04-30",
"year_ago_actual_eps": 3.46,
"year_ago_actual_revenue": 70066000000,
"eps_growth_yoy_pct": 23.41,
"revenue_growth_yoy_pct": 18.3,
"last_earnings_move_pct": -3.93,
"avg_earnings_move_pct": 5.2,
"price_reaction": {
"reaction_date": "2026-04-30",
"pre_earnings_close": 424.46,
"gap_pct": -3.22,
"move_1d_pct": -3.93,
"move_3d_pct": -2.55,
"move_5d_pct": -2.47,
"pre_earnings_move_5d_pct": -1.95,
"volume_ratio": 2.2
},
"days_to_next_earnings": 41,
"next_earnings_date": "2026-10-28",
"has_transcript": true,
"surprise_history": [
{
"date": "2026-04-29",
"actual_eps": 4.27,
"estimated_eps": 4.06,
"eps_surprise_pct": 5.17
},
{
"date": "2026-01-28",
"actual_eps": 4.14,
"estimated_eps": 3.9,
"eps_surprise_pct": 6.15
},
{
"date": "2025-10-29",
"actual_eps": 4.13,
"estimated_eps": 3.67,
"eps_surprise_pct": 12.53
},
{
"date": "2025-07-30",
"actual_eps": 3.65,
"estimated_eps": 3.37,
"eps_surprise_pct": 8.31
}
]
},
{
"date": "2026-01-28",
"ticker": "MSFT",
"fiscal_year": 2026,
"fiscal_quarter": 2,
"period_end_date": "2025-12-31",
"earnings_timing": "after_market",
"earnings_call_timestamp": 1769639400,
"actual_revenue": 81273000000,
"estimated_revenue": 80308700000,
"revenue_difference": 964300000,
"revenue_difference_pct": 1.2007,
"actual_eps": 4.14,
"actual_eps_gaap": 5.16,
"estimated_eps": 3.9,
"eps_difference": 0.24,
"eps_difference_pct": 6.1538,
"sec_filing_type": "10-Q",
"sec_filing_date": "2026-01-28",
"report_date_status": "projected",
"date_confirmed": false,
"report_datetime": null,
"sec_8k_url": null,
"eps_beat_miss": "beat",
"revenue_beat_miss": "beat",
"eps_surprise_streak": 14,
"avg_eps_surprise_pct_4q": 8.61,
"eps_sue": 1.88,
"year_ago_date": "2025-01-29",
"year_ago_actual_eps": 3.23,
"year_ago_actual_revenue": 69632000000,
"eps_growth_yoy_pct": 28.17,
"revenue_growth_yoy_pct": 16.72,
"last_earnings_move_pct": -9.99,
"avg_earnings_move_pct": 6.12,
"price_reaction": {
"reaction_date": "2026-01-29",
"pre_earnings_close": 481.63,
"gap_pct": -8.65,
"move_1d_pct": -9.99,
"move_3d_pct": -12.1,
"move_5d_pct": -14,
"pre_earnings_move_5d_pct": 8.45,
"volume_ratio": 4.9
},
"days_to_next_earnings": 41,
"next_earnings_date": "2026-10-28",
"has_transcript": true,
"surprise_history": [
{
"date": "2026-01-28",
"actual_eps": 4.14,
"estimated_eps": 3.9,
"eps_surprise_pct": 6.15
},
{
"date": "2025-10-29",
"actual_eps": 4.13,
"estimated_eps": 3.67,
"eps_surprise_pct": 12.53
},
{
"date": "2025-07-30",
"actual_eps": 3.65,
"estimated_eps": 3.37,
"eps_surprise_pct": 8.31
},
{
"date": "2025-04-30",
"actual_eps": 3.46,
"estimated_eps": 3.22,
"eps_surprise_pct": 7.45
}
]
}
]

Code Examples

curl -X GET "https://api.api-ninjas.com/v1/earningscalendar?date=2024-01-15" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

Premium only

https://api.api-ninjas.com/v1/earningscalendarlist

Returns a list of all available companies in the earnings calendar. Use it to find tickers for the /v1/earningscalendar endpoint.

Parameters

This endpoint does not require any parameters.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.

  • ticker

    The company ticker symbol.

  • company

    The company name.

Live Demo

Live demo · no API key required
Query parameters

This endpoint has no parameters. Click Try it to fetch the list of all available companies.

Get a free API key to get started — no credit card required.

Headers
X-Api-KeyLog in or sign up to get your API key
GET
https://api.api-ninjas.com/v1/earningscalendarlist
Sample response
[
{
"ticker": "MSFT",
"company": "Microsoft Corporation"
},
{
"ticker": "AAPL",
"company": "Apple Inc."
},
{
"ticker": "GOOG",
"company": "Alphabet Inc."
},
{
"ticker": "AMZN",
"company": "Amazon.com Inc."
},
{
"ticker": "TSLA",
"company": "Tesla Inc."
},
"..."
]

Code Examples

curl -X GET "https://api.api-ninjas.com/v1/earningscalendarlist" \ -H "X-Api-Key: YOUR_API_KEY"

Premium only

https://api.api-ninjas.com/v1/upcomingearnings

Returns a list of upcoming earnings dates with filtering capabilities. You can filter by date range, single date, exchange, or ticker symbol. Results are limited to dates from today onwards.

Parameters

All parameters are optional. If no parameters are provided, returns upcoming earnings from today onwards (up to 100 results).

  • start_date  optional

    Start date in YYYY-MM-DD format (e.g., 2024-01-15). Must be today or later. Defaults to today if not provided.

  • end_date  optional

    End date in YYYY-MM-DD format (e.g., 2024-12-31). Must be after start_date. Defaults to 10 years from today if not provided.

  • date  optional

    Single date in YYYY-MM-DD format (e.g., 2024-01-15). If provided, overrides start_date and end_date to filter by this exact date.

  • exchange  optional

    Exchange code to filter by (e.g., NASDAQ, NYSE, HKSE, LSE, TSX). Returns only earnings from companies listed on the specified exchange.

  • ticker  optional

    Ticker symbol to filter by (e.g., AAPL, 0700.HK). Returns only earnings for that specific company.

  • limit  optional

    Maximum number of results to return. Must be between 1 and 100 (inclusive). Default is 100.

  • offset  optional

    Number of results to skip for pagination. Must be a non-negative integer. Use in combination with limit to paginate through results.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.

  • ticker

    The ticker symbol of the company.

  • date

    The date of the upcoming earnings (YYYY-MM-DD format).

  • eps_estimated

    The estimated earnings per share, in the company's reporting currency (may be null).

  • revenue_estimated

    The estimated revenue, in the company's reporting currency (may be null).

  • exchange

    The exchange code where the company is listed (e.g., NASDAQ, NYSE, HKSE).

  • earnings_timing

    Timing of the earnings call. Omitted when the company's earnings timing is not yet known. Possible values are:

    • before_market: Earnings call occurs before the market opens.

    • during_market: Earnings call occurs during regular market hours.

    • after_market: Earnings call occurs after the market closes.

Live Demo

Live demo · no API key required
Query parameters
start_date
end_date
date
exchange
ticker
limit
offset

Get a free API key to get started — no credit card required.

Headers
X-Api-KeyLog in or sign up to get your API key
GET
https://api.api-ninjas.com/v1/upcomingearnings?exchange=NASDAQ
Sample response
[
{
"ticker": "ADSE",
"date": "2026-05-15",
"eps_estimated": -0.0235,
"revenue_estimated": 123323600,
"exchange": "NASDAQ"
},
{
"ticker": "ALLR",
"date": "2026-05-15",
"eps_estimated": -0.22,
"revenue_estimated": 320000,
"exchange": "NASDAQ"
},
{
"ticker": "AREC",
"date": "2026-05-15",
"eps_estimated": -0.095,
"revenue_estimated": 1000000,
"exchange": "NASDAQ"
},
"..."
]

Code Examples

curl -X GET "https://api.api-ninjas.com/v1/upcomingearnings?exchange=NASDAQ" \ -H "X-Api-Key: YOUR_API_KEY"

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the Earnings Calendar API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • The API covers more than 50,000 tickers on US and international exchanges, including NYSE, Nasdaq, London, Toronto, Germany, Tokyo, Hong Kong, Shanghai, Shenzhen and India, with earnings history back to 2000 and upcoming report dates up to about a year ahead. EPS and revenue are returned in each company's reporting currency rather than converted to USD, so Toyota (7203.T) is reported in JPY.
  • Call /v1/earningscalendar with a ticker, date, or date_start/date_end range and show_upcoming=true to include scheduled future reports, or use /v1/upcomingearnings to filter upcoming dates by exchange. The earnings_timing field tells you whether the company reports before_market, during_market, or after_market, and earnings_call_timestamp gives the call time as a Unix timestamp. Upcoming dates, estimates, and timing are available on premium plans.
  • The calendar is refreshed every day. Actual EPS and revenue appear with the next daily refresh after a company reports, and estimates are updated as they change. Upcoming dates are projections until the company reports, and companies sometimes move them, so re-check dates close to the event: when a date moves, the old date is removed on the next refresh. On Business plans, report_date_status switches to confirmed once the company files its 8-K earnings release with the SEC, and report_datetime gives the exact filing time.
  • Both are available. actual_eps and estimated_eps are on the adjusted (non-GAAP) basis that analyst consensus uses, so the surprise fields compare like with like. actual_eps_gaap is GAAP diluted EPS taken from the company's SEC 10-Q or 10-K, with sec_filing_type, sec_filing_date, and period_end_date showing where it came from. GAAP EPS is available for US SEC filers once the filing is published, usually on the report day; fourth-quarter values are derived from the annual 10-K.
  • Business, Professional, and annual plans add earnings analytics to every row: eps_beat_miss and revenue_beat_miss, the beat streak, 4-quarter average surprise, standardized unexpected earnings (eps_sue), and surprise_history; year-ago EPS and revenue with eps_growth_yoy_pct and revenue_growth_yoy_pct; the price_reaction to the report (opening gap, 1-, 3- and 5-day moves, pre-earnings run-up, and volume ratio) and the average move over the last 4 reports; the next earnings date; and whether a transcript is available in the Earnings Call Transcript API.
  • Pass date (for example 2026-07-30) for a single day or date_start and date_end for a range. Results are sorted by date, newest first, then by ticker, and each request returns up to 50 rows, so page through busy days with offset=50, offset=100, and so on. The calendar includes international listings; to narrow upcoming reports to one exchange, use /v1/upcomingearnings with the exchange parameter.
  • /v1/earningscalendar returns past results and upcoming dates by ticker, date, or date range. /v1/earningscalendarlist returns every covered company's ticker and company name. /v1/upcomingearnings returns upcoming dates filtered by date range, exchange, or ticker, with a limit of up to 100 rows. The latter two endpoints are premium only. For full income statements, balance sheets, and cash flows from each filing, see the Earnings API.

Explore API integration use cases for recommended APIs and workflow examples.