## Get Instrument Earnings Transcripts

`$ clst 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.

### Parameters

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

- `--date: optional object { gt, gte, lt, lte }`

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

- `--page-size: optional number`

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

- `--page-token: optional string`

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

- `--period: optional "Q1" or "Q2" or "Q3" or "Q4"`

  Only return the transcript for this fiscal quarter.

- `--year: optional number`

  Only return the transcript for this fiscal year.

### Returns

- `V1InstrumentDataGetInstrumentEarningsTranscriptsResponse: BaseResponse`

  - `data: array of InstrumentEarningsTranscript`

    - `content: string`

      The full text of the transcript

    - `date: string`

      The date of the earnings call

    - `period: "Q1" or "Q2" or "Q3" or "Q4"`

      The fiscal quarter of the call

      - `"Q1"`

      - `"Q2"`

      - `"Q3"`

      - `"Q4"`

    - `period_type: "QUARTERLY" or "ANNUAL" or "TTM" or "BIANNUAL"`

      The type of fiscal period. Always `QUARTERLY`.

      - `"QUARTERLY"`

      - `"ANNUAL"`

      - `"TTM"`

      - `"BIANNUAL"`

    - `year: number`

      The fiscal year of the call

### Example

```cli
clst v1:instrument-data get-instrument-earnings-transcripts \
  --api-key 'My API Key' \
  --instrument-id x
```

#### 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"
  }
}
```