Endpoints

Calendar

List the earnings call events scheduled on a specific date.

GEThttps://edge.alpha.earningscall.dev/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.

The list comes back under events, next to a meta object that carries the request id and the item count — see the response envelope.

Parameters#

apikeystringRequired

Your API key. May also be sent as the x-api-key header.

yearintegerRequired

4-digit year, e.g. 2025.

monthintegerRequired

Calendar month, 1–12.

dayintegerRequired

Day of month, 1–31.

Examples#

Fetch calls scheduled on a specific day#

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

Response

{
  "events": [
    {
      "symbol": "TLRY",
      "company_name": "Tilray Brands, Inc.",
      "exchange": "NASDAQ",
      "conference_date": "2025-01-10T08:30:00.000-05:00",
      "year": 2025,
      "quarter": 2,
      "transcript_ready": true
    },
    {
      "symbol": "WBA",
      "company_name": "Walgreens Boots Alliance, Inc.",
      "exchange": "NASDAQ",
      "conference_date": "2025-01-10T08:30:00.000-05:00",
      "year": 2025,
      "quarter": 1,
      "transcript_ready": true
    },
    {
      "symbol": "DAL",
      "company_name": "Delta Air Lines, Inc.",
      "exchange": "NYSE",
      "conference_date": "2025-01-10T10:00:00-05:00",
      "year": 2024,
      "quarter": 4,
      "transcript_ready": true
    }
  ],
  "meta": {
    "request_id": "77c18f2d-b668-4513-af72-5d63befcd901",
    "total": 16,
    "next_cursor": null
  }
}

{
  "events": [
    {
      "symbol": "TLRY",
      "company_name": "Tilray Brands, Inc.",
      "exchange": "NASDAQ",
      "conference_date": "2025-01-10T08:30:00.000-05:00",
      "year": 2025,
      "quarter": 2,
      "transcript_ready": true
    },
    {
      "symbol": "WBA",
      "company_name": "Walgreens Boots Alliance, Inc.",
      "exchange": "NASDAQ",
      "conference_date": "2025-01-10T08:30:00.000-05:00",
      "year": 2025,
      "quarter": 1,
      "transcript_ready": true
    },
    {
      "symbol": "DAL",
      "company_name": "Delta Air Lines, Inc.",
      "exchange": "NYSE",
      "conference_date": "2025-01-10T10:00:00-05:00",
      "year": 2024,
      "quarter": 4,
      "transcript_ready": true
    }
  ],
  "meta": {
    "request_id": "77c18f2d-b668-4513-af72-5d63befcd901",
    "total": 16,
    "next_cursor": null
  }
}

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.