Get Instrument Earnings Transcripts

$ clst v1:instrument-data get-instrument-earnings-transcripts

GET/v1/instruments/{instrument_id}/earnings-transcripts

Retrieves earnings call transcripts for a specific instrument, newest fiscal period first.

Defaults: page_size is 1 and is capped at 5, because each transcript is large. Send event_date with the date of an earnings event from the events endpoints to fetch that event’s transcript. The date.gt, date.gte, date.lt, and date.lte filters compare the call date itself. An instrument without transcripts returns an empty list.

Pagination metadata does not include total_items or total_pages for this endpoint. Use next_page_token to detect whether more results exist. The token does not carry filters: send the same filters with every page request.

ParametersExpand Collapse

--instrument-id: string

Instrument identifier: either an instrument UUID or a symbol (symbol for equities, OSI for options). Non-UUID inputs are resolved server-side.

--date: optional object { gt, gte, lt, lte }

--event-date: optional string

Return only transcripts whose call date is within one day of this earnings event date (YYYY-MM-DD). Use an event’s date to fetch that event’s transcript.

--page-size: optional number

The number of items to return per page. Only used when page_token is not provided.

--page-token: optional string

Token for retrieving the next or previous page of results. Contains encoded pagination state; when provided, page_size is ignored.

--period: optional "Q1" or "Q2" or "Q3" or "Q4"

Only return the transcript for this fiscal quarter.

--year: optional number

Only return the transcript for this fiscal year.

ReturnsExpand Collapse

V1InstrumentDataGetInstrumentEarningsTranscriptsResponse: BaseResponse { metadata, error }

data: array of InstrumentEarningsTranscript { content, date, period, 2 more }

content: string

The full text of the transcript

date: string

The date of the earnings call

period: "Q1" or "Q2" or "Q3" or "Q4"

The fiscal quarter of the call

"Q1"

"Q2"

"Q3"

"Q4"

period_type: "QUARTERLY" or "ANNUAL" or "TTM" or "BIANNUAL"

The type of fiscal period. Always QUARTERLY.

"QUARTERLY"

"ANNUAL"

"TTM"

"BIANNUAL"

year: number

The fiscal year of the call

Get Instrument Earnings Transcripts

clst v1:instrument-data get-instrument-earnings-transcripts \
  --api-key 'My API Key' \
  --instrument-id x

{
  "data": [
    {
      "content": "Operator: Good afternoon, and welcome to the Apple Q3 2025 earnings call...",
      "date": "2025-07-31",
      "period": "Q3",
      "period_type": "QUARTERLY",
      "year": 2025
    }
  ],
  "error": null,
  "metadata": {
    "next_page_token": "AAAAAAAAAAEAAAAAAAAAAQ==",
    "page_number": 1,
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

{
  "error": {
    "code": 404,
    "message": "Instrument not found: AAPL"
  },
  "metadata": {
    "request_id": "fa8cc9b2-fbf0-4f5b-8ce3-b3205b9f85f2"
  }
}

Returns Examples

{
  "data": [
    {
      "content": "Operator: Good afternoon, and welcome to the Apple Q3 2025 earnings call...",
      "date": "2025-07-31",
      "period": "Q3",
      "period_type": "QUARTERLY",
      "year": 2025
    }
  ],
  "error": null,
  "metadata": {
    "next_page_token": "AAAAAAAAAAEAAAAAAAAAAQ==",
    "page_number": 1,
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

{
  "error": {
    "code": 404,
    "message": "Instrument not found: AAPL"
  },
  "metadata": {
    "request_id": "fa8cc9b2-fbf0-4f5b-8ce3-b3205b9f85f2"
  }
}