Special Situations

Export situations

Enqueue an async bulk Special Situations export from the same snapshot/issue renderer (JSON, CSV, Excel, PDF, or Copy-for-LLM).

get/v1/situations/export

Request

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

Query parameters

typesstring

Comma-separated situation_type values.

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.

formsstring

Comma-separated EDGAR form types (e.g. SC 13D,SC TO-T,425). Expands each form to the situation types it opens and filters to them.

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'
format'json' | 'csv' | 'xlsx' | 'pdf' | 'llm' | 'excel' | 'markdown' | 'md'

Export format. excel aliases xlsx; markdown and md alias llm. Large exports are generated asynchronously.

issuestring

Optional weekly-issue number or slug. When set, the export uses the frozen published snapshots instead of the live roster.

situation_idstring

Optional single-situation filter for the async job.

Response

Queued export job. Poll GET /v1/exports/{job_id} or wait for export.completed.

object'export_job' required
jobIdstring required
status'queued' | 'running' | 'completed' | 'failed' required
dataset'company_overview' | 'macro_observations' | 'situations' required
format'json' | 'csv' | 'xlsx' | 'pdf' | 'llm' required
rowCountinteger required
byteSizeinteger required
downloadUrlstring nullable required
expiresAtstring nullable required
contentHashstring nullable
revisionIdstring nullable
replayedboolean
errorTextstring

Changes

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