## Get Instrument Earnings Transcripts

`client.V1.InstrumentData.GetInstrumentEarningsTranscripts(ctx, instrumentID, query) (*V1InstrumentDataGetInstrumentEarningsTranscriptsResponse, error)`

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

- `instrumentID string`

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

- `query V1InstrumentDataGetInstrumentEarningsTranscriptsParams`

  - `Date param.Field[V1InstrumentDataGetInstrumentEarningsTranscriptsParamsDate]`

    - `Gt string`

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

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

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

      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.

  - `EventDate param.Field[Time]`

    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.

  - `PageSize param.Field[int64]`

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

  - `PageToken param.Field[string]`

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

  - `Period param.Field[V1InstrumentDataGetInstrumentEarningsTranscriptsParamsPeriod]`

    Only return the transcript for this fiscal quarter.

    - `const V1InstrumentDataGetInstrumentEarningsTranscriptsParamsPeriodQ1 V1InstrumentDataGetInstrumentEarningsTranscriptsParamsPeriod = "Q1"`

    - `const V1InstrumentDataGetInstrumentEarningsTranscriptsParamsPeriodQ2 V1InstrumentDataGetInstrumentEarningsTranscriptsParamsPeriod = "Q2"`

    - `const V1InstrumentDataGetInstrumentEarningsTranscriptsParamsPeriodQ3 V1InstrumentDataGetInstrumentEarningsTranscriptsParamsPeriod = "Q3"`

    - `const V1InstrumentDataGetInstrumentEarningsTranscriptsParamsPeriodQ4 V1InstrumentDataGetInstrumentEarningsTranscriptsParamsPeriod = "Q4"`

  - `Year param.Field[int64]`

    Only return the transcript for this fiscal year.

### Returns

- `type V1InstrumentDataGetInstrumentEarningsTranscriptsResponse struct{…}`

  - `Data InstrumentEarningsTranscriptList`

    - `Content string`

      The full text of the transcript

    - `Date Time`

      The date of the earnings call

    - `Period FiscalQuarter`

      The fiscal quarter of the call

      - `const FiscalQuarterQ1 FiscalQuarter = "Q1"`

      - `const FiscalQuarterQ2 FiscalQuarter = "Q2"`

      - `const FiscalQuarterQ3 FiscalQuarter = "Q3"`

      - `const FiscalQuarterQ4 FiscalQuarter = "Q4"`

    - `PeriodType FiscalPeriodType`

      The type of fiscal period. Always `QUARTERLY`.

      - `const FiscalPeriodTypeQuarterly FiscalPeriodType = "QUARTERLY"`

      - `const FiscalPeriodTypeAnnual FiscalPeriodType = "ANNUAL"`

      - `const FiscalPeriodTypeTtm FiscalPeriodType = "TTM"`

      - `const FiscalPeriodTypeBiannual FiscalPeriodType = "BIANNUAL"`

    - `Year int64`

      The fiscal year of the call

### Example

```go
package main

import (
  "context"
  "fmt"

  "github.com/clear-street/clear-street-go"
  "github.com/clear-street/clear-street-go/option"
)

func main() {
  client := clearstreet.NewClient(
    option.WithAPIKey("My API Key"),
  )
  response, err := client.V1.InstrumentData.GetInstrumentEarningsTranscripts(
    context.TODO(),
    "x",
    clearstreet.V1InstrumentDataGetInstrumentEarningsTranscriptsParams{

    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", 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"
  }
}
```