---
title: "Get fund letter"
method: GET
path: "/v1/fund-letters/{letter_id}"
tags: ["Fund Letters"]
---

# Get fund letter

`GET /v1/fund-letters/{letter_id}`

## Request

- Base URL: `https://api.turos.app`
- URL: `https://api.turos.app/v1/fund-letters/{letter_id}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Detail never inlines page markdown (that is the /document endpoint, metered separately), so view=agent and view=compact currently equal the default detail view.

## Path parameters

- `letter_id` string, required

## Query parameters

- `view` 'default' | 'compact' | 'agent'

## Response `200`

Successful response

- FundLetterDetail
  - `object` 'fund_letter', required
  - `id` string, required
  - `createdAt` string, required
  - `updatedAt` string, required
  - `livemode` boolean, required
  - `requestedId` string, nullable
  - `managerId` string, nullable, required
  - `managerName` string, nullable, required
  - `fundId` string, nullable, required
  - `fundName` string, nullable, required
  - `letterType` 'hedge_fund_letter' | 'registered_fund_letter' | 'corporate_shareholder_letter' | 'quarterly_shareholder_letter', required
  - `source` 'fund_website' | 'edgar' | 'aggregator', required
  - `distribution` 'public_record' | 'fund_published' | 'third_party', required
  - `issuerCik` string, nullable
  - `issuerTicker` string, nullable
  - `title` string, nullable, required
  - `period` object, required
    - `year` integer, nullable, required
    - `quarter` integer, nullable, required
    - `period` string, nullable, required
    - `label` string, nullable
    - `fiscalPeriodEnd` string, nullable
  - `publishedAt` string, nullable, required
  - `ingestedAt` string, required
  - `pageCount` integer, nullable, required
  - `wordCount` integer, nullable, required
  - `paginationVersion` string, required
  - `tickersMentioned` string[], required
  - `thesisCount` integer, required
  - `performanceSummary` object, nullable, required
    - `netReturnPercent` number, nullable, required
    - `benchmarkName` string, nullable, required
    - `benchmarkReturnPercent` number, nullable, required
  - `provenance` object, required
    - `sourceUrl` string, nullable, required
    - `accessionNumber` string, nullable, required
    - `sourceSha256` string, required
    - `pdfSha256` string, nullable, required
    - `retrievedAt` string, nullable, required
    - `extractorVersion` string, nullable, required
    - `confidence` 'fund_authenticated' | 'third_party_unverified' | 'leak_sourced', required
  - `links` object, required
  - `narratives` object, required
    - `marketBackdrop` object, nullable, required
      - `text` string, required
      - `anchors` object[], required
        - `page` integer, required
        - `charStart` integer, required
        - `charEnd` integer, required
        - `quote` string, required
        - `sourceSha256` string, required
        - `paginationVersion` string, required
    - `positioning` object, nullable, required
      - `text` string, required
      - `anchors` object[], required
        - `page` integer, required
        - `charStart` integer, required
        - `charEnd` integer, required
        - `quote` string, required
        - `sourceSha256` string, required
        - `paginationVersion` string, required
    - `performanceCommentary` object, nullable, required
      - `text` string, required
      - `anchors` object[], required
        - `page` integer, required
        - `charStart` integer, required
        - `charEnd` integer, required
        - `quote` string, required
        - `sourceSha256` string, required
        - `paginationVersion` string, required
    - `outlook` object, nullable, required
      - `text` string, required
      - `anchors` object[], required
        - `page` integer, required
        - `charStart` integer, required
        - `charEnd` integer, required
        - `quote` string, required
        - `sourceSha256` string, required
        - `paginationVersion` string, required
    - `firmUpdates` object, nullable, required
      - `text` string, required
      - `anchors` object[], required
        - `page` integer, required
        - `charStart` integer, required
        - `charEnd` integer, required
        - `quote` string, required
        - `sourceSha256` string, required
        - `paginationVersion` string, required
  - `performanceFigures` object[], required
    - `label` string, nullable, required
    - `period` string, nullable, required
    - `netReturnPercent` number, nullable, required
    - `benchmarkName` string, nullable, required
    - `benchmarkReturnPercent` number, nullable, required
    - `anchors` object[], required
      - `page` integer, required
      - `charStart` integer, required
      - `charEnd` integer, required
      - `quote` string, required
      - `sourceSha256` string, required
      - `paginationVersion` string, required
  - `theses` object[], required
    - `object` 'fund_letter_thesis', required
    - `id` string, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `livemode` boolean, required
    - `requestedId` string, nullable
    - `letterId` string, required
    - `managerId` string, nullable, required
    - `managerName` string, nullable, required
    - `fundId` string, nullable, required
    - `company` object, required
      - `ticker` string, nullable, required
      - `cik` string, nullable, required
      - `name` string, required
      - `entityId` string, nullable, required
    - `reportPeriod` string, nullable, required
    - `relationship` 'long' | 'short' | 'new_position' | 'added' | 'trimmed' | 'sold' | 'exited' | 'watchlist' | 'negative_research' | 'issuer', required
    - `stance` 'bullish' | 'bearish' | 'mixed' | 'neutral', nullable, required
    - `conviction` 'high' | 'medium' | 'low' | 'unknown', nullable, required
    - `convictionBasis` 'as_expressed', required
    - `timeHorizon` string, nullable, required
    - `positionSize` object, nullable, required
      - `percent` number, nullable, required
      - `basis` string, nullable, required
    - `materiality` object, required
      - `basis` string[], required
    - `thesisSummary` string, nullable, required
    - `variantPerception` string, nullable, required
    - `riskSummary` string, nullable, required
    - `catalystSummary` string, nullable, required
    - `valuationSummary` string, nullable, required
    - `businessQualitySummary` string, nullable, required
    - `managementAssessment` string, nullable, required
    - `capitalAllocationSummary` string, nullable, required
    - `financialExpectations` string, nullable, required
    - `performanceOrActionSummary` string, nullable, required
    - `sourceQuote` object, nullable, required
      - `text` string, required
      - `anchors` object[], required
        - `page` integer, required
        - `charStart` integer, required
        - `charEnd` integer, required
        - `quote` string, required
        - `sourceSha256` string, required
        - `paginationVersion` string, required
    - `quoteAsExtracted` string, nullable
    - `crossLinks` object, required
      - `holdings13F` string, nullable, required
      - `holderHistory` string, nullable, required
      - `insiderActivity` string, nullable, required
      - `companyFilings` string, nullable, required
    - `status` 'active' | 'superseded', required
    - `supersededBy` string, nullable, required

## Other responses

- `default`: Contract-aware error response

---

[API](https://skmtc.dev/turos/apis/turos-api.md) · [All operations](https://skmtc.dev/turos/apis/turos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/turos/apis/turos-api/revisions/a68d3ec80a56?raw)