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

## Request

- Base URL: `https://api.fiscal.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.fiscal.ai/v1/company/fund-letters`
- Auth: API key in query parameter `apiKey`

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/fiscal-api.md) - [All operations](https://skmtc.dev/fiscal/apis/fiscal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fiscal/apis/fiscal-api/revisions/85026fdfc8b8?raw)