## Get Instrument Earnings Transcripts

`v1.instrument_data.get_instrument_earnings_transcripts(strinstrument_id, InstrumentDataGetInstrumentEarningsTranscriptsParams**kwargs)  -> InstrumentDataGetInstrumentEarningsTranscriptsResponse`

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

- `instrument_id: str`

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

- `date: Optional[Date]`

  - `gt: Optional[str]`

    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.

  - `gte: Optional[str]`

    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.

  - `lt: Optional[str]`

    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.

  - `lte: Optional[str]`

    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.

- `event_date: Optional[Union[null, null]]`

  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[int]`

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

- `page_token: Optional[Union[str, Base64FileInput]]`

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

- `period: Optional[Literal["Q1", "Q2", "Q3", "Q4"]]`

  Only return the transcript for this fiscal quarter.

  - `"Q1"`

  - `"Q2"`

  - `"Q3"`

  - `"Q4"`

- `year: Optional[int]`

  Only return the transcript for this fiscal year.

### Returns

- `class InstrumentDataGetInstrumentEarningsTranscriptsResponse: …`

  - `data: InstrumentEarningsTranscriptList`

    - `content: str`

      The full text of the transcript

    - `date: date`

      The date of the earnings call

    - `period: FiscalQuarter`

      The fiscal quarter of the call

      - `"Q1"`

      - `"Q2"`

      - `"Q3"`

      - `"Q4"`

    - `period_type: FiscalPeriodType`

      The type of fiscal period. Always `QUARTERLY`.

      - `"QUARTERLY"`

      - `"ANNUAL"`

      - `"TTM"`

      - `"BIANNUAL"`

    - `year: int`

      The fiscal year of the call

### Example

```python
from clearstreet import ClearStreet

client = ClearStreet(
    api_key="My API Key",
)
response = client.v1.instrument_data.get_instrument_earnings_transcripts(
    instrument_id="x",
)
print(response)
```

#### 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"
  }
}
```