CLclear-street
Instrument Data

Get Instrument Earnings Transcripts

Changed on

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.

get/v1/instruments/{instrument_id}/earnings-transcripts

Request

  • Base URL
    https://api.clearstreet.com
  • Auth
    HTTP bearer

Path parameters

instrument_idstring required

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

Instrument ID (UUID) or symbol (equity ticker or OSI option symbol).

Query parameters

yearinteger

Only return the transcript for this fiscal year.

period'Q1' | 'Q2' | 'Q3' | 'Q4'

Fiscal quarter of a reporting period

Only return the transcript for this fiscal quarter.

event_datestring date

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.

date.gtstring

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.

date.gtestring

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.

date.ltstring

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.

date.ltestring

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.

page_sizeinteger

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

page_tokenstring byte

Base64URL-encoded pagination token

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

Response

List of earnings call transcripts

Example response

{
  "error": {
    "code": 400,
    "message": "Order quantity must be greater than zero"
  },
  "metadata": {
    "page_number": 1,
    "total_items": 42,
    "total_pages": 5
  },
  "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
    }
  ]
}

Changes