GETNewPaid 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

Free tier includes 60 requests per minute, 100 requests per day, and 1,000 requests per month. Paid plans are built for production use with higher limits and a 300 requests per minute rate limit. Daily and monthly reset windows use New York time.

View usage