---
title: "Get fund-letter theses for a company"
method: GET
path: "/v1/company/fund-letters"
tags: ["Fund Letters"]
---

# Get fund-letter theses for a company

`GET /v1/company/fund-letters`

Returns everything professional investors' letters say about one company: the resolved company block, coverage stats, and every published thesis (newest reporting period first) — each with its stance, conviction, position sizing, thesis/risk/catalyst/valuation summaries, a representative source quote, and a reference to the investor, fund and letter it came from.

Accepts every standard company identifier (companyKey, ticker + exchange/micCode, CUSIP, ISIN, FIGI, CIK, or the Fiscal.ai company identifier). Returns 404 for companies without fund-letter coverage — /v1/fund-letters/companies lists the covered universe.

## Query parameters

- `apiKey` string — API Key (alternatively send via X-Api-Key header)
- `ticker` string — Company ticker, use with mic or alone for US tickers
- `micCode` string — Company MIC, use with ticker
- `exchange` string — Company exchange code, use with ticker
- `companyKey` string — Company key (alternative to ticker/micCode/exchange)
- `cusip` string — Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company CUSIP
- `isin` string — Requires CUSIP/ISIN license. An alternative to ticker/micCode/exchange. Company ISIN
- `figi` string — FIGI (Financial Instrument Global Identifier). An alternative to ticker/micCode/exchange.
- `cik` string — Company CIK (SEC Central Index Key). An alternative to ticker/micCode/exchange.
- `fscl` string — Fiscal.ai stable company identifier (the companyFiscalIdentifier field). An alternative to ticker/micCode/exchange.

## Response `200`

The company's fund-letter thesis feed.

- object
  - `company` object, required
    - `companyFiscalIdentifier` string, required — Fiscal.ai stable company identifier (usable with every company endpoint).
    - `companyKey` string, required — Fiscal.ai company key (exchangeCode_ticker).
    - `displayNameEnglish` string, required — Common display name.
    - `sector` string, required — GICS sector
    - `industryGroup` string, required — GICS industry group
    - `industry` string, required — GICS industry
    - `subIndustry` string, required — GICS sub-industry
    - `headquartersCountryCode` string, required — Headquarters country (ISO 3166-1 alpha-2)
    - `headquartersCountryName` string, required — Headquarters country
    - `marketCapUsd` number, required — USD market cap as of the latest publish — served only when computed from shares outstanding × prices (as on the v3 companies list); null otherwise.
    - `primaryListing` object, required
      - `ticker` string, required
      - `exchangeCode` string, required — Listing exchange code
      - `exchangeName` string, required
      - `operatingMic` string, required — Operating MIC of the listing exchange
  - `stats` object, required
    - `letterCount` number, required
    - `investorCount` number, required
    - `fundCount` number, required
    - `firstPeriod` string, required
    - `latestPeriod` string, required
  - `theses` object[], required — Every published thesis on this company, newest reporting period first.
    - `materialityBasis` string[], required — Why this company discussion is material: substantive_thesis, performance_attribution, portfolio_action, meaningful_position_size, valuation_discussion, catalyst_discussion, risk_or_bear_case, substantive_negative_view, mistake_or_exit_review.
    - `relationship` string, required — The investor's relationship to the company in this letter: long, short, new_position, added, trimmed, sold, exited, watchlist, negative_research, or issuer.
    - `stance` string, required — Overall stance: bullish, bearish, mixed, or neutral.
    - `conviction` string, required — Conviction the letter expresses: high, medium, low, or unknown.
    - `positionSizePercent` number, required — Disclosed position size in percent, only when the letter states it for this security individually. Nullable.
    - `positionSizeBasis` string, required — What the percentage is measured against (portfolio, fund, nav, aum, net, gross, other). Nullable.
    - `positionSizeDescription` string, required — Qualitative sizing language when no number is disclosed. Nullable.
    - `timeHorizon` string, required — Stated investment horizon: short_term, medium_term, or long_term. Nullable.
    - `thesisSummary` string, required — Concise summary of the investment thesis as argued in the letter.
    - `sourceQuote` string, required — Representative verbatim quote from the letter. Nullable.
    - `variantPerception` string, required — Where the investor believes they differ from consensus. Nullable.
    - `riskSummary` string, required — Risks the letter itself flags for this position. Nullable.
    - `catalystSummary` string, required — Catalysts the letter identifies. Nullable.
    - `valuationSummary` string, required — The letter's valuation argument. Nullable.
    - `businessQualitySummary` string, required — The letter's view on business quality/moat. Nullable.
    - `managementAssessment` string, required — The letter's assessment of management. Nullable.
    - `capitalAllocationSummary` string, required — The letter's view on capital allocation. Nullable.
    - `financialExpectations` string, required — Financial expectations the letter states (growth, margins, earnings power). Nullable.
    - `performanceOrActionSummary` string, required — What the position did for performance and/or what action the investor took. Nullable.
    - `decisionRelevantTakeaways` string[], required — Decision-relevant takeaways extracted from the discussion.
    - `monitoringPoints` string[], required — What the investor says they are watching from here.
    - `investor` object, required
      - `investorId` string, required
      - `investorName` string, required
    - `fund` object, required
      - `fundId` string, required
      - `fundName` string, required
    - `letter` object, required
      - `letterId` string, required
      - `title` string, required
      - `reportPeriod` string, required — Canonical reporting period (YYYYQn).
      - `reportPeriodYear` number, required
      - `reportPeriodQuarter` number, required

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.dev/fiscal/apis/openapi.md) · [All operations](https://skmtc.dev/fiscal/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fiscal/openapi/revisions/706968b7c65f/schema)