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

Get Instrument Earnings Transcripts

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.

Path ParametersExpand Collapse
instrument_id: 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 ParametersExpand Collapse
date: optional object { gt, gte, lt, lte }
gt: optional 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 for accepted formats, bare-date expansion, and combining bounds. Returns 400 if the resulting range is inverted.

gte: optional 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 for accepted formats, bare-date expansion, and combining bounds. Returns 400 if the resulting range is inverted.

lt: optional 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 for accepted formats, bare-date expansion, and combining bounds. Returns 400 if the resulting range is inverted.

lte: optional 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 for accepted formats, bare-date expansion, and combining bounds. Returns 400 if the resulting range is inverted.

event_date: optional string

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
page_size: optional number

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

formatint64
maximum5
minimum1
page_token: optional string

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

formatbyte
period: optional "Q1" or "Q2" or "Q3" or "Q4"

Only return the transcript for this fiscal quarter.

One of the following:
"Q1"
"Q2"
"Q3"
"Q4"
year: optional number

Only return the transcript for this fiscal year.

formatint32
ReturnsExpand Collapse
data: InstrumentEarningsTranscriptList { content, date, period, 2 more }
content: string

The full text of the transcript

date: string

The date of the earnings call

formatdate

The fiscal quarter of the call

One of the following:
"Q1"
"Q2"
"Q3"
"Q4"
period_type: FiscalPeriodType

The type of fiscal period. Always QUARTERLY.

One of the following:
"QUARTERLY"
"ANNUAL"
"TTM"
"BIANNUAL"
year: number

The fiscal year of the call

formatint32

Get Instrument Earnings Transcripts

curl https://api.clearstreet.com/v1/instruments/$INSTRUMENT_ID/earnings-transcripts \
    -H "Authorization: Bearer $API_KEY"
{
  "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"
  }
}