---
title: "Company letter coverage"
method: GET
path: "/v1/fund-letters/companies"
tags: ["Fund Letters"]
---

# Company letter coverage

`GET /v1/fund-letters/companies`

## Request

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

Use this to find which companies managers have written about before drilling into `/v1/fund-letters/theses`. Counts reflect extracted theses rather than passing mentions. Metered as fund_letter_lookup.

## Query parameters

- `ticker` string
- `cik` string
- `cursor` integer
- `limit` integer

## Response `200`

Successful response

- FundLetterCompanyCoverageList
  - `object` 'list', required
  - `data` object[], required
    - `object` 'fund_letter_company_coverage', required
    - `company` object, required
      - `ticker` string, nullable, required
      - `cik` string, nullable, required
      - `name` string, nullable, required
      - `entityId` string, nullable, required
    - `thesisCount` integer, required
    - `managerCount` integer, required
    - `letterCount` integer, required
    - `firstPeriod` string, nullable, required
    - `latestPeriod` string, nullable, required
    - `latestStance` 'bullish' | 'bearish' | 'mixed' | 'neutral', nullable, required
    - `latestRelationship` 'long' | 'short' | 'new_position' | 'added' | 'trimmed' | 'sold' | 'exited' | 'watchlist' | 'negative_research' | 'issuer', nullable, 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)