Fund Letters

Search letter text

Metered as fund_letter_search. Results are a relevance-ranked top-N (hasMore is always false; raise limit or narrow filters to deepen recall). Every highlight anchor verifies against /document?format=markdown bytes. When the full-text engine is unavailable the response degrades to Postgres lexical search, reported via degradedState.

get/v1/fund-letters/search

Request

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

Query parameters

qstring required

Full-text query over letter bodies.

manager_idstring

mgr_-prefixed manager id.

fund_idstring

fnd_-prefixed fund id.

tickerstring

Letters mentioning this ticker (tickers_mentioned).

issuer_cikstring

Letters published by this issuer CIK.

issuer_tickerstring

Letters published by this issuer. Canonical form is BRK-B, not BRK.B.

letter_type'hedge_fund_letter' | 'registered_fund_letter' | 'corporate_shareholder_letter' | 'quarterly_shareholder_letter'
source'fund_website' | 'edgar' | 'aggregator'

Where the canonical source bytes came from.

distribution'public_record' | 'fund_published' | 'third_party'

Rights tier governing what /document serves.

periodstring

Reporting period (YYYY or YYYYQn). Year-only aliases to YYYYQ4 for Berkshire-style IR years.

yearinteger
quarterinteger
published_fromstring

Inclusive lower bound (ISO date/datetime) on publishedAt.

published_tostring

Inclusive upper bound (ISO date/datetime) on publishedAt.

limitinteger

Response

Successful response

object'list' required
hasMoreboolean required
nextCursorstring nullable required
responseMode'compact' | 'standard' | 'verbose' nullable
includestring[] nullable
requestIdstring required

Changes

No recorded changes to this operation across all 1 revision of this API.