---
title: "A company's investor events — earnings calls plus other webcast events (conferences, investor days, shareholder meetings) — newest first. Event ids feed the per-event speakers and slides endpoints."
method: GET
path: "/v1/stocks/{ticker}/investor-events"
tags: ["EarningsCalls"]
---

# A company's investor events — earnings calls plus other webcast events (conferences, investor days, shareholder meetings) — newest first. Event ids feed the per-event speakers and slides endpoints.

`GET /v1/stocks/{ticker}/investor-events`

## Request

- Base URL: `https://api.equibles.com`
- URL: `https://api.equibles.com/v1/stocks/{ticker}/investor-events`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/equibles/apis/equibles-api/docs/v1/stocks/:ticker/investor-events/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `ticker` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `eventType` string
- `includeUncaptured` boolean

## Response `200`

OK

- InvestorEventDtoPagedResponse
  - `listingNotice` ListingNotice: What happened to a requested ticker that no longer trades. "delisted": the company has no current US listing, so the answer is its history. "renamed": the company now trades as successorTicker, its current US presentation ticker (possibly another share class). A listed series (short volume, short interest, off-exchange volume, fails-to-deliver, congressional trades) is the retired ticker's own; a company-level read is the company's data.
    - `status` string, nullable: "delisted" or "renamed".
    - `ticker` string, nullable: The retired ticker as listed.
    - `delistedOn` string, date, nullable: The day the retired listing stopped trading, when known.
    - `successorTicker` string, nullable: For "renamed", the company's current US presentation ticker; null for "delisted".
  - `data` InvestorEventDto[], nullable
    - `id` string, uuid
    - `eventType` string, nullable
    - `eventTypeName` string, nullable
    - `title` string, nullable
    - `callDate` string, date-time
    - `callDateIsPeriodEnd` boolean: True when callDate is only the end of the call's fiscal quarter, held until the real call date is known; treat the call date as not confirmed. Always false for events other than earnings calls.
    - `fiscalYear` integer, nullable
    - `fiscalQuarter` integer, nullable
    - `status` string, nullable
    - `statusName` string, nullable
    - `webcastUrl` string, nullable
    - `transcriptDocumentId` string, uuid, nullable
    - `earningsReleaseDocumentId` string, uuid, nullable
    - `hasAudio` boolean
    - `hasSlides` boolean
    - `hasTranscript` boolean: Whether a speaker-labelled transcript is available via the speakers endpoints. Broader than transcriptDocumentId: an audio-pipeline transcription stores speaker turns without a transcript document, so gate on this flag, not the document id.
    - `materials` InvestorEventMaterialsDto
      - `transcript` MaterialStatusDto
        - `status` string, nullable: The material's state: "available" (on file), "pending" (not yet, and a capture lane will still try or the call has not happened), "notPublished" (the company published none, such as no replay or no deck), "failed" (we tried and could not capture or process it), "notAttempted" (no lane has tried it) or "noCallHeld" (the event had no call).
        - `reason` string, nullable: A short human-readable reason for the status.
        - `lastAttemptAt` string, date-time, nullable: When the capture lane last attempted this material; null when unknown or never attempted.
        - `nextAttemptAt` string, date-time, nullable: When the capture lane will next try or recheck it; null when no attempt is scheduled.
      - `audio` MaterialStatusDto
        - `status` string, nullable: The material's state: "available" (on file), "pending" (not yet, and a capture lane will still try or the call has not happened), "notPublished" (the company published none, such as no replay or no deck), "failed" (we tried and could not capture or process it), "notAttempted" (no lane has tried it) or "noCallHeld" (the event had no call).
        - `reason` string, nullable: A short human-readable reason for the status.
        - `lastAttemptAt` string, date-time, nullable: When the capture lane last attempted this material; null when unknown or never attempted.
        - `nextAttemptAt` string, date-time, nullable: When the capture lane will next try or recheck it; null when no attempt is scheduled.
      - `slides` MaterialStatusDto
        - `status` string, nullable: The material's state: "available" (on file), "pending" (not yet, and a capture lane will still try or the call has not happened), "notPublished" (the company published none, such as no replay or no deck), "failed" (we tried and could not capture or process it), "notAttempted" (no lane has tried it) or "noCallHeld" (the event had no call).
        - `reason` string, nullable: A short human-readable reason for the status.
        - `lastAttemptAt` string, date-time, nullable: When the capture lane last attempted this material; null when unknown or never attempted.
        - `nextAttemptAt` string, date-time, nullable: When the capture lane will next try or recheck it; null when no attempt is scheduled.
    - `isTombstoned` boolean, nullable: True on an event hidden by default because none of its materials could be captured; only includeUncaptured=true returns one. Omitted otherwise.
    - `presentationOnly` boolean, nullable: True when the audio and transcript are the company's presentation only: the company published no recording of the Q&A. Omitted otherwise.
    - `partialRecording` boolean, nullable: True when the audio and transcript come from a live recording that joined the call after it began: the opening is missing until the company's replay replaces them. Omitted otherwise.
  - `meta` PageMeta
    - `limit` integer
    - `offset` integer
    - `count` integer
    - `hasMore` boolean
    - `total` integer, nullable

## Other responses

- `400`: Bad Request
- `404`: Not Found

## Changes

- **2026-11-06** `666e06778588`: 12 info
  - added the new optional `query` request parameter `eventType`
  - added the new optional `query` request parameter `includeUncaptured`
  - added the new optional `query` request parameter `offset`
  - added the non-success response with the status `400`
  - …8 more

[Operation history](https://skmtc.dev/equibles/apis/equibles-api/changes/v1/stocks/:ticker/investor-events/get.md)

---

[API](https://skmtc.dev/equibles/apis/equibles-api.md) - [All operations](https://skmtc.dev/equibles/apis/equibles-api/llms.txt) - [OpenAPI document](https://skmtc.dev/equibles/apis/equibles-api/revisions/83f13ba1a993?raw)
