Get free API key
Docs menuexpand_more
travel_exploreTry in the API Viewer

Guides

Endpoints

search
appsAll APIs
functionHow metrics are calculated

Cookbook

List upcoming earnings dates

/stable/earnings-calendar returns scheduled and already reported earnings dates. Fetch a date range and keep only the companies you hold.

Key points

  • check_circleThe range is at most 93 days. Without it, the window is 30 days before and after today.
  • check_circlelimit caps the rows: 200 by default, up to 500.
  • check_circleEach call uses 1 token.

Endpoints to use

Code

Replace YOUR_API_KEY with a key issued in your dashboard. Switch languages with the tabs.

Code example
# The range is at most 93 days
curl -sG "https://api.zenithcode.net/stable/earnings-calendar" \
  --data-urlencode "from=2026-10-20" \
  --data-urlencode "to=2026-11-03" \
  -H "x-api-key: YOUR_API_KEY"

How the code works

  1. 1Call with from set to today and to set to 14 days later.
  2. 2Keep rows whose symbol is in your holdings.
  3. 3Show them in order of reportDate.

Things to note

  • errorPeak reporting weeks have many rows. Shorten the range or set limit to the maximum of 500.
  • errorDates follow company announcements and can change.

FAQ for investors and developers

When do March fiscal-year companies report?expand_more

One to two months after the fiscal year end; for March year-ends, reports cluster in mid-May.

Can I add them to Google Calendar?expand_more

Use CalendarApp in Apps Script to create events from the dates.

FAQ for AI builders and researchers

Can I tell whether results are out?expand_more

Reported rows may have a value in actualEps. null means not yet reported or not captured.

How do I let an AI answer this week's earnings schedule?expand_more

Use the MCP tool get_earnings_calendar, and tell it to interpret dates in Japan time.

gavel

Disclaimer

This page explains how to use a Japanese equity data API and how its data is defined. It is not a solicitation to invest or a recommendation to buy or sell any security. The content reflects information at the time of writing and is not guaranteed to be accurate or complete. Investment decisions are your own responsibility.

What you may show or provide to third parties depends on your plan and Article 8 of the Terms. Exchange data such as stock prices may not be shown to third parties on any plan. Terms, Article 8 · Data sources and terms of use