Special Situations

Situations by filing form

List special situations opened or advanced by a given EDGAR form type (e.g. SC 13D, SC TO-T, 425, DEFM14A). The form is expanded to the situation types it triggers.

get/v1/situations/by-form/{form}

Request

  • Base URL: https://api.turos.app
  • URL: https://api.turos.app/v1/situations/by-form/{form}
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Path parameters

formstring required

EDGAR form type, URL-encoded (e.g. SC%2013D).

Query parameters

subtypesstring

Comma-separated subtype values.

statusesstring

Comma-separated lifecycle statuses.

tickersstring

Comma-separated tickers.

sectorsstring

Comma-separated sectors.

market_capstring

Comma-separated market-cap buckets (nano|micro|small|mid|large|mega).

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).

countrystring

ISO 3166-1 alpha-2 country filter.

announced_fromstring

Lower bound (ISO date) on announced date.

announced_tostring

Upper bound (ISO date) on announced date.

updated_fromstring

Lower bound (ISO datetime) on last update.

updated_tostring

Upper bound (ISO datetime) on last update.

enrich'true' | 'false'

When false, returns a minimal stripped projection instead of the full situation. Billed identically.

cursorinteger
limitinteger
response_mode'compact' | 'standard' | 'verbose' | 'agent'

Response

Successful response

OR

Changes

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