---
title: "Get Instrument Earnings Transcripts"
method: GET
path: "/v1/instruments/{instrument_id}/earnings-transcripts"
tags: ["Instrument Data"]
---

# Get Instrument Earnings Transcripts

`GET /v1/instruments/{instrument_id}/earnings-transcripts`

## Request

- Base URL: `https://api.clearstreet.com`
- URL: `https://api.clearstreet.com/v1/instruments/{instrument_id}/earnings-transcripts`
- Auth: HTTP bearer

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 parameters

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

## Query parameters

- `year` integer
- `period` 'Q1' | 'Q2' | 'Q3' | 'Q4': Fiscal quarter of a reporting period
- `event_date` string, date
- `date.gt` string
- `date.gte` string
- `date.lt` string
- `date.lte` string
- `page_size` integer
- `page_token` string, byte: Base64URL-encoded pagination token

## Response `200`

List of earnings call transcripts

- object
  - `error` ApiError: A direct mapping of tonic::Status, for use in HTTP responses.
    - `code` integer, required: The error code is used to identify the nature of the error. It corresponds to an HTTP status code.
    - `details` object[]
    - `message` string, required: A human-readable message providing more details about the error.
  - `metadata` ResponseMetadata, required: Metadata for the response. This will always contain a request ID which can be used to identify the request to Clear Street for tracing, and optionally may include pagination data.
    - `next_page_token` string, byte, nullable: Base64URL-encoded pagination token
    - `page_number` integer, nullable: Pagination. Included if this was a GET (list) response
    - `previous_page_token` string, byte, nullable: Base64URL-encoded pagination token
    - `request_id` string, required: A unique ID for this request, generated upon ingestion of the request.
    - `total_items` integer, nullable: Total number of items available (not just in this page).
    - `total_pages` integer, nullable: Total number of pages available.
  - `data` InstrumentEarningsTranscript[], required
    - `content` string, required: The full text of the transcript
    - `date` string, date, required: The date of the earnings call
    - `period` 'Q1' | 'Q2' | 'Q3' | 'Q4', required: Fiscal quarter of a reporting period
    - `period_type` 'QUARTERLY' | 'ANNUAL' | 'TTM' | 'BIANNUAL', required: Fiscal period type for earnings reports
    - `year` integer, required: The fiscal year of the call

## Other responses

- `400`: Invalid query parameter
- `404`: Instrument not found
- `500`: Internal server error

## Changes

- **2026-10-21** `49c5c6b23633`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/clear-street/apis/clear-street-trading-api/changes/v1/instruments/:instrument_id/earnings-transcripts/get.md)

---

[API](https://skmtc.dev/clear-street/apis/clear-street-trading-api.md) - [All operations](https://skmtc.dev/clear-street/apis/clear-street-trading-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clear-street/apis/clear-street-trading-api/revisions/52e77ea7d731?raw)