Endpoints

Calendar

List the earnings call events scheduled on a specific date.

GEThttps://v2.api.alpha.earningscall.biz/calendar

Returns every earnings call event scheduled for a given calendar date. Use this endpoint to surface upcoming calls in a watchlist, build an earnings tracker, or prefetch transcript availability.

Demo accounts can only request 2025-01-10. Paid plans can request any date from 1980 to five years in the future.

Parameters#

ParameterTypeDescription
apikeystringRequiredYour API key. May also be sent as the x-api-key header.
yearintegerRequired4-digit year, e.g. 2025.
monthintegerRequiredCalendar month, 1–12.
dayintegerRequiredDay of month, 1–31.

Examples#

Fetch calls scheduled on a specific day#

curl 'https://v2.api.alpha.earningscall.biz/calendar?apikey=demo&year=2025&month=1&day=10'

Response

[
  {
    "exchange": "NASDAQ",
    "symbol": "TLRY",
    "year": 2025,
    "quarter": 2,
    "conference_date": "2025-01-10T08:30:00.000-05:00",
    "company_name": "Tilray Brands, Inc.",
    "transcript_ready": true
  },
  {
    "exchange": "NASDAQ",
    "symbol": "WBA",
    "year": 2025,
    "quarter": 1,
    "conference_date": "2025-01-10T08:30:00.000-05:00",
    "company_name": "Walgreens Boots Alliance, Inc.",
    "transcript_ready": true
  },
  {
    "exchange": "NYSE",
    "symbol": "DAL",
    "year": 2024,
    "quarter": 4,
    "conference_date": "2025-01-10T10:00:00.000-05:00",
    "company_name": "Delta Air Lines, Inc.",
    "transcript_ready": true
  }
]

Error responses#

See the Errors page for the full error format. This endpoint can return:

400missing_parameter — Missing year, month, or day.400invalid_parameter — Non-integer or out-of-range value.401invalid_api_key — Auth failure.403demo_restriction — Demo account requesting a date other than 2025-01-10.404resource_not_found — No earnings calls found for the requested date.429rate_limit_exceeded — Plan rate limit exceeded.