Embed

Public situations list

Anonymous, recent-only public list of Special Situations. Rows include SEC filing accession numbers and public citation provenance.

get/v1/embed/situations

Request

  • Base URL: https://api.turos.app
  • URL: https://api.turos.app/v1/embed/situations
  • Auth: none required

Query parameters

typesstring

Comma-separated situation_type values. At most 25 values are honored.

statusesstring

Comma-separated lifecycle statuses. At most 25 values are honored.

tickersstring

Comma-separated tickers. At most 25 values are honored.

sectorsstring

Comma-separated sectors. At most 25 values are honored.

market_capstring

Comma-separated market-cap buckets (nano|micro|small|mid|large|mega). At most 25 values are honored.

market_cap_minnumber

Inclusive lower bound on stored market-cap USD.

market_cap_maxnumber

Inclusive upper bound on stored market-cap USD.

evstring

Comma-separated enterprise-value buckets (nano|micro|small|mid|large|mega). At most 25 values are honored.

countrystring

ISO 3166-1 alpha-2 country filter. Unknown codes match zero stored rows.

announced_fromstring

Lower bound (ISO date) on announced date.

announced_tostring

Upper bound (ISO date) on announced date.

updated_fromstring

Lower bound (ISO date or datetime) on last update. Cannot expand the free 180-day window.

updated_tostring

Upper bound (ISO date or datetime) on last update.

qstring

Public search query over headline, entity name, and ticker.

cursorstring

Public page cursor in {windowStart}:{offset} form.

limitinteger

Response

Successful response

object'list' required
hasMoreboolean required
nextCursorstring
degradedStateunknown
generatedAtstring required
asOfstring

Changes

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