Endpoints

Calendar

List the earnings call events scheduled on a specific date.

GEThttps://api.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.

A day on which no company reports is not an error: it is a 200 with an empty events list.

The response is an object, with the list under events — see list responses.

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#

The response below shows three of the sixteen calls on that day.

curl 'https://api.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-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-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
    }
  ]
}

{
  "events": [
    {
      "symbol": "TLRY",
      "company_name": "Tilray Brands, Inc.",
      "exchange": "NASDAQ",
      "conference_date": "2025-01-10T08:30:00-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-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
    }
  ]
}

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, or a date that does not exist, such as 30 February.401invalid_api_key — Auth failure.403demo_restriction — Demo account requesting a date other than 2025-01-10.429rate_limit_exceeded — Plan rate limit exceeded.503service_unavailable — The day could not be read. Retry after 2 seconds.