---
title: "List fund letters"
method: GET
path: "/v1/fund-letters"
tags: ["Fund Letters"]
---

# List fund letters

`GET /v1/fund-letters`

## Request

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

Documented coverage begins with letters published in 2025 Q1 and is not a historical archive. view=compact returns the trimmed FundLetterCompactList projection (billed identically); view=agent currently equals the default view.

## Query parameters

- `manager_id` string
- `fund_id` string
- `ticker` string
- `cik` string
- `issuer_cik` string
- `issuer_ticker` string
- `letter_type` 'hedge_fund_letter' | 'registered_fund_letter' | 'corporate_shareholder_letter' | 'quarterly_shareholder_letter'
- `source` 'fund_website' | 'edgar' | 'aggregator'
- `distribution` 'public_record' | 'fund_published' | 'third_party'
- `period` string
- `year` integer
- `quarter` integer
- `published_from` string
- `published_to` string
- `since` string
- `sort` 'published_at_desc' | 'published_at_asc' | 'updated_at_desc' | 'updated_at_asc' | 'period_desc' | 'period_asc'
- `cursor` integer
- `limit` integer
- `view` 'default' | 'compact' | 'agent'

## Response `200`

Successful response

- union
  - FundLetterList
    - `object` 'list', required
    - `data` object[], required
      - `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
    - `hasMore` boolean, required
    - `nextCursor` string, nullable, required
    - `responseMode` 'compact' | 'standard' | 'verbose', nullable
    - `include` string[], nullable
    - `requestId` string, required
  - FundLetterCompactList
    - `object` 'list', required
    - `data` object[], required
      - `id` string, required
      - `managerId` string, nullable, required
      - `managerName` string, nullable, required
      - `fundId` string, nullable, required
      - `letterType` 'hedge_fund_letter' | 'registered_fund_letter' | 'corporate_shareholder_letter' | 'quarterly_shareholder_letter', required
      - `period` string, nullable, required
      - `publishedAt` string, nullable, required
      - `title` string, nullable, required
      - `thesisCount` integer, required
    - `hasMore` boolean, required
    - `nextCursor` string, nullable, required
    - `responseMode` 'compact' | 'standard' | 'verbose', nullable
    - `include` string[], nullable
    - `requestId` string, 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)