## Get Instrument Earnings Transcripts

`InstrumentDataGetInstrumentEarningsTranscriptsResponse v1().instrumentData().getInstrumentEarningsTranscripts(InstrumentDataGetInstrumentEarningsTranscriptsParamsparams = InstrumentDataGetInstrumentEarningsTranscriptsParams.none(), RequestOptionsrequestOptions = RequestOptions.none())`

**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.

### Parameters

- `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.

  - `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](https://docs.clearstreet.com/guides/api-fundamentals#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](https://docs.clearstreet.com/guides/api-fundamentals#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](https://docs.clearstreet.com/guides/api-fundamentals#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](https://docs.clearstreet.com/guides/api-fundamentals#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.

  - `Optional<Long> pageSize`

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

  - `Optional<String> pageToken`

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

  - `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.

### Returns

- `class InstrumentDataGetInstrumentEarningsTranscriptsResponse:`

  - `List<InstrumentEarningsTranscript> data`

    - `String content`

      The full text of the transcript

    - `LocalDate date`

      The date of the earnings call

    - `FiscalQuarter period`

      The fiscal quarter of the call

      - `Q1("Q1")`

      - `Q2("Q2")`

      - `Q3("Q3")`

      - `Q4("Q4")`

    - `FiscalPeriodType periodType`

      The type of fiscal period. Always `QUARTERLY`.

      - `QUARTERLY("QUARTERLY")`

      - `ANNUAL("ANNUAL")`

      - `TTM("TTM")`

      - `BIANNUAL("BIANNUAL")`

    - `long year`

      The fiscal year of the call

### Example

```java
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");
    }
}
```

#### Response

```json
{
  "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"
  }
}
```