Endpoints

Events

List all earnings call events for a specific company.

GEThttps://v2.api.alpha.earningscall.biz/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.

Parameters#

ParameterTypeDescription
apikeystringRequiredYour API key.
exchangestringRequiredStock exchange, e.g. NASDAQ or NYSE. Case-insensitive.
symbolstringRequiredTicker symbol. Case-insensitive.

Examples#

Get every event for Apple#

curl 'https://v2.api.alpha.earningscall.biz/events?apikey=demo&exchange=NASDAQ&symbol=AAPL'

Response

{
  "company_name": "Apple Inc.",
  "events": [
    {
      "year": 2024,
      "quarter": 2,
      "conference_date": "2024-05-02T17:00:00.000-04:00"
    },
    {
      "year": 2024,
      "quarter": 1,
      "conference_date": "2024-02-01T17:00:00.000-05:00"
    },
    {
      "year": 2023,
      "quarter": 4,
      "conference_date": "2023-11-03T17:00:00.000-04:00"
    },
    {
      "year": 2023,
      "quarter": 3,
      "conference_date": "2023-08-03T17:00:00.000-04:00"
    },
    {
      "year": 2023,
      "quarter": 2,
      "conference_date": "2023-05-04T14:00:00.000-07:00"
    },
    {
      "year": 2023,
      "quarter": 1,
      "conference_date": "2023-02-02T17:00:00.000-05:00"
    }
  ]
}

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.