Skip to content
Clear Street Clear Street Clear Street
Start Trading
API Reference
V1
Instrument Data

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.

ParametersExpand Collapse
instrumentID string

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

minLength1
query V1InstrumentDataGetInstrumentEarningsTranscriptsParams
Gt stringOptional

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.

Gte stringOptional

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.

Lt stringOptional

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.

Lte stringOptional

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.

EventDate param.Field[Time]Optional

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
PageSize param.Field[int64]Optional

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

formatint64
maximum5
minimum1
PageToken param.Field[string]Optional

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

formatbyte

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]Optional

Only return the transcript for this fiscal year.

formatint32
ReturnsExpand Collapse
type V1InstrumentDataGetInstrumentEarningsTranscriptsResponse struct{…}
Content string

The full text of the transcript

Date Time

The date of the earnings call

formatdate

The fiscal quarter of the call

One of the following:
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.

One of the following:
const FiscalPeriodTypeQuarterly FiscalPeriodType = "QUARTERLY"
const FiscalPeriodTypeAnnual FiscalPeriodType = "ANNUAL"
const FiscalPeriodTypeTtm FiscalPeriodType = "TTM"
const FiscalPeriodTypeBiannual FiscalPeriodType = "BIANNUAL"
Year int64

The fiscal year of the call

formatint32

Get Instrument Earnings Transcripts

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)
}

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