GETNewPro only/v1/earnings-release-times

Earnings Release Times

See the time range in which a company's earnings releases occurred over its most recent three quarters.

⚡ This is a historical release-time range based on the company's most recent three quarters, not a guaranteed time for its next earnings release. The from and to values use 24-hour HH:mm format in the returned timezone.

Request

GET https://api.earningsapi.com/v1/earnings-release-times?symbol=AAPL&apikey=YOUR_API_KEY
RequestPython
import requests

response = requests.get("https://api.earningsapi.com/v1/earnings-release-times?symbol=AAPL", params={"apikey": "YOUR_API_KEY"}, timeout=30)
response.raise_for_status()
print(response.json())

Query parameters

NameTypeRequiredDescription
symbolstringYesStock ticker symbol (e.g., "AAPL")

Response fields

FieldTypeDescription
symbolstringStock ticker symbol
fromstringStart of the historical range in which releases occurred over the most recent three quarters, in 24-hour HH:mm format
tostringEnd of the historical range in which releases occurred over the most recent three quarters, in 24-hour HH:mm format
timezonestringIANA timezone for the from and to values (e.g., America/New_York)

Response example

JSON response
{
  "symbol": "AAPL",
  "from": "16:30",
  "to": "16:40",
  "timezone": "America/New_York"
}

Quota and limits

Compare plan limits and historical data access.

Free

  • 60 requests / minute
  • 100 requests / day
  • 1,000 requests / month
  • The most recent 24 months of historical data on supported endpoints

Pro

  • 300 requests / minute
  • Unlimited daily requests
  • Unlimited monthly requests
  • All available history on supported endpoints

Free daily and monthly quotas reset in New York time. Historical access applies to endpoints marked Historical access.

View usage and plans