Endpoints

Events

List all earnings call events for a specific company.

GEThttps://edge.alpha.earningscall.dev/events

Returns every earnings call on record for a single ticker, ordered most-recent-first. Use this to discover which year/quarter pairs are available before fetching a transcript or audio file.

The response names its company with exchange and symbol, in upper case however you wrote them, so a stored response still says which company it describes.

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.

exchangestringRequired

Stock exchange, e.g. NASDAQ or NYSE. Case-insensitive.

symbolstringRequired

Ticker symbol. Case-insensitive.

Examples#

Get every event for Apple#

curl 'https://edge.alpha.earningscall.dev/events?apikey=demo&exchange=NASDAQ&symbol=AAPL'

curl 'https://edge.alpha.earningscall.dev/events?apikey=demo&exchange=NASDAQ&symbol=AAPL'

import earningscall

company = earningscall.get_company("AAPL")
for event in company.events():
    print(event.year, event.quarter, event.conference_date)

import { getCompany } from "earningscall";

const company = await getCompany({ symbol: "AAPL" });
const events = await company.events();
console.log(events);

Response

{
  "exchange": "NASDAQ",
  "symbol": "AAPL",
  "company_name": "Apple Inc.",
  "events": [
    {
      "year": 2026,
      "quarter": 3,
      "conference_date": "2026-07-30T14:00:00-07:00",
      "is_published": true
    },
    {
      "year": 2026,
      "quarter": 2,
      "conference_date": "2026-04-30T14:00:00-07:00",
      "is_published": true
    },
    {
      "year": 2026,
      "quarter": 1,
      "conference_date": "2026-01-29T17:00:00.000-05:00",
      "is_published": true
    },
    {
      "year": 2025,
      "quarter": 4,
      "conference_date": "2025-10-30T17:00:00.000-04:00",
      "is_published": true
    },
    {
      "year": 2025,
      "quarter": 3,
      "conference_date": "2025-07-31T17:00:00.000-04:00",
      "is_published": true
    },
    {
      "year": 2025,
      "quarter": 2,
      "conference_date": "2025-05-01T17:00:00.000-04:00",
      "is_published": true
    }
  ],
  "meta": {
    "request_id": "1dbc999f-3c5e-4e3f-9c85-8a679c41e130",
    "total": 33,
    "next_cursor": null
  }
}

{
  "exchange": "NASDAQ",
  "symbol": "AAPL",
  "company_name": "Apple Inc.",
  "events": [
    {
      "year": 2026,
      "quarter": 3,
      "conference_date": "2026-07-30T14:00:00-07:00",
      "is_published": true
    },
    {
      "year": 2026,
      "quarter": 2,
      "conference_date": "2026-04-30T14:00:00-07:00",
      "is_published": true
    },
    {
      "year": 2026,
      "quarter": 1,
      "conference_date": "2026-01-29T17:00:00.000-05:00",
      "is_published": true
    },
    {
      "year": 2025,
      "quarter": 4,
      "conference_date": "2025-10-30T17:00:00.000-04:00",
      "is_published": true
    },
    {
      "year": 2025,
      "quarter": 3,
      "conference_date": "2025-07-31T17:00:00.000-04:00",
      "is_published": true
    },
    {
      "year": 2025,
      "quarter": 2,
      "conference_date": "2025-05-01T17:00:00.000-04:00",
      "is_published": true
    }
  ],
  "meta": {
    "request_id": "1dbc999f-3c5e-4e3f-9c85-8a679c41e130",
    "total": 33,
    "next_cursor": null
  }
}

Error responses#

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

400missing_parameter — Missing exchange or symbol.401invalid_api_key — Auth failure.403demo_restriction — Demo account requesting a ticker other than AAPL or MSFT on NASDAQ.404resource_not_found — No events found for the requested company.429rate_limit_exceeded — Plan rate limit exceeded.