---
title: "Situation event feed"
method: GET
path: "/v1/situations/feed"
tags: ["Special Situations"]
---

# Situation event feed

`GET /v1/situations/feed`

## Request

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

Reverse-chronological feed of situation events, each enriched with its parent situation summary.

## Query parameters

- `types` string
- `categories` string
- `tickers` string
- `sectors` string
- `market_cap` string
- `market_cap_min` number
- `market_cap_max` number
- `ev` string
- `country` string
- `announced_from` string
- `announced_to` string
- `updated_from` string
- `updated_to` string
- `since` string
- `cursor` integer
- `limit` integer

## Response `200`

Successful response

- SituationFeedItemList
  - `object` 'list', required
  - `data` object[], required
    - `object` 'situation_feed_item', required
    - `event` object, required
      - `object` 'situation_event', required
      - `id` string, required
      - `createdAt` string, required
      - `livemode` boolean, required
      - `situationId` string, required
      - `occurredAt` string, required
      - `accessionNumber` string, required
      - `formType` string, required
      - `eightKItems` string[], required
      - `category` 'merger_acquisition' | 'tender_offer' | 'going_private' | 'spin_off' | 'divestiture' | 'activist_activity' | 'restructuring' | 'bankruptcy' | 'liquidation' | 'strategic_review' | 'capital_return' | 'securities_offering' | 'delisting_action' | 'relisting_action' | 'legal_dispute' | 'management_change' | 'domicile_change' | 'insider_transaction' | 'financial_distress' | 'payment_default' | 'credit_rating' | 'capital_structure' | 'dividend_policy' | 'accounting_change' | 'auditor_change' | 'investment' | 'ipo' | 'earnings_report' | 'earnings_call' | 'guidance_update' | 'investor_conference' | 'expansion' | 'contract_award' | 'product_launch' | 'regulatory_inspection' | 'operational_disruption' | 'labor_issue' | 'name_change' | 'other', nullable, required
      - `title` string, required
      - `summaryMd` string, nullable
      - `statusBefore` 'rumored' | 'announced' | 'pending' | 'completed' | 'terminated' | 'expired', nullable, required
      - `statusAfter` 'rumored' | 'announced' | 'pending' | 'completed' | 'terminated' | 'expired', nullable, required
      - `documentUrl` string, uri, nullable, required
      - `verification` object, required
        - `sourceSpan` string, nullable
        - `extractionTraceId` string, nullable
        - `confidence` number, nullable
        - `crossValidations` object[], required
          - `name` string, required
          - `passed` boolean, required
          - `expected` unknown
          - `actual` unknown
          - `deviation` number, nullable
        - `modelVersion` string, nullable
        - `verifiedAt` string, nullable
    - `situation` object, required
      - `id` string, required
      - `type` 'merger' | 'tender_offer' | 'going_private' | 'spin_off' | 'divestiture' | 'activist_campaign' | 'restructuring' | 'bankruptcy' | 'liquidation' | 'strategic_review' | 'capital_return' | 'capital_raise' | 'spac' | 'delisting' | 'relisting' | 'litigation' | 'management_change' | 'domicile_change' | 'demutualization' | 'other', required
      - `subtype` 'definitive' | 'preliminary' | 'unsolicited' | 'rumor_response' | 'scheme_of_arrangement' | 'spac_merger' | 'self_tender' | 'third_party' | 'exchange_offer' | 'management_buyout' | 'sponsor_buyout' | 'squeeze_out' | 'spin_off' | 'split_off' | 'carve_out_ipo' | 'asset_sale' | 'joint_venture' | 'carve_out' | 'stake_disclosure' | 'proxy_contest' | 'cooperation_agreement' | 'settlement' | 'debt_for_equity_swap' | 'out_of_court' | 'operational' | 'chapter_11' | 'chapter_7' | 'chapter_15' | 'administration' | 'prepackaged' | 'emergence' | 'plan_of_liquidation' | 'dissolution' | 'formal_alternatives' | 'sale_process' | 'buyback_authorization' | 'special_dividend' | 'recapitalization' | 'rights_offering' | 'public_offering' | 'private_placement' | 'pipe' | 'atm_program' | 'ipo' | 'extension' | 'trust_liquidation' | 'forced' | 'voluntary' | 'uplisting' | 'otc_relisting' | 'won' | 'lost' | 'settled' | 'ceo' | 'cfo' | 'chair' | 'board' | 'redomiciliation', nullable, required
      - `status` 'rumored' | 'announced' | 'pending' | 'completed' | 'terminated' | 'expired', required
      - `ticker` string, nullable, required
      - `entityName` string, required
      - `headline` string, required
      - `market` object, required
        - `price` number, nullable
        - `marketCapUsd` number, nullable
        - `marketCapBucket` 'nano' | 'micro' | 'small' | 'mid' | 'large' | 'mega', nullable
        - `enterpriseValueUsd` number, nullable
        - `asOf` string, nullable
  - `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)