Get Instrument Earnings Transcripts

InstrumentDataGetInstrumentEarningsTranscriptsResponse v1().instrumentData().getInstrumentEarningsTranscripts(, )

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

InstrumentDataGetInstrumentEarningsTranscriptsParams params

Optional<String> instrumentId

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

minLength1

Optional<Date> date

Optional<String> gt

Return only rows where date is strictly after the given value. A bare YYYY-MM-DD date expands to the end of that day (UTC), so this matches from the start of the following day. See Range filters for accepted formats, bare-date expansion, and combining bounds. Returns 400 if the resulting range is inverted.

Optional<String> gte

Return only rows where date is on or after the given value. A bare YYYY-MM-DD date expands to the start of that day (UTC). See Range filters for accepted formats, bare-date expansion, and combining bounds. Returns 400 if the resulting range is inverted.

Optional<String> lt

Return only rows where date is strictly before the given value. A bare YYYY-MM-DD date expands to the start of that day (UTC). See Range filters for accepted formats, bare-date expansion, and combining bounds. Returns 400 if the resulting range is inverted.

Optional<String> lte

Return only rows where date is on or before the given value. A bare YYYY-MM-DD date expands to the end of that day (UTC), so this matches through the end of that day. See Range filters for accepted formats, bare-date expansion, and combining bounds. Returns 400 if the resulting range is inverted.

Optional<LocalDate> eventDate

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.

formatdate

Optional<Long> pageSize

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

formatint64

maximum5

minimum1

Optional<String> pageToken

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

formatbyte

Optional<Period> period

Only return the transcript for this fiscal quarter.

Q1("Q1")

Q2("Q2")

Q3("Q3")

Q4("Q4")

Optional<Long> year

Only return the transcript for this fiscal year.

formatint32

ReturnsExpand Collapse

class InstrumentDataGetInstrumentEarningsTranscriptsResponse:

List<InstrumentEarningsTranscript> data

String content

The full text of the transcript

LocalDate date

The date of the earnings call

formatdate

FiscalQuarter period

The fiscal quarter of the call

One of the following:

Q1("Q1")

Q2("Q2")

Q3("Q3")

Q4("Q4")

FiscalPeriodType periodType

The type of fiscal period. Always QUARTERLY.

One of the following:

QUARTERLY("QUARTERLY")

ANNUAL("ANNUAL")

TTM("TTM")

BIANNUAL("BIANNUAL")

long year

The fiscal year of the call

formatint32

Get Instrument Earnings Transcripts

package com.clearstreet.api.example;

import com.clearstreet.api.client.ClearStreetClient;
import com.clearstreet.api.client.okhttp.ClearStreetOkHttpClient;
import com.clearstreet.api.models.v1.instrumentdata.InstrumentDataGetInstrumentEarningsTranscriptsParams;
import com.clearstreet.api.models.v1.instrumentdata.InstrumentDataGetInstrumentEarningsTranscriptsResponse;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        ClearStreetClient client = ClearStreetOkHttpClient.builder()
            .fromEnv()
            .apiKey("My API Key")
            .build();

        InstrumentDataGetInstrumentEarningsTranscriptsResponse response = client.v1().instrumentData().getInstrumentEarningsTranscripts("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"
  }
}