---
title: "Public situations list"
method: GET
path: "/v1/embed/situations"
tags: ["Embed"]
---

# Public situations list

`GET /v1/embed/situations`

## Request

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

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

## Query parameters

- `types` string
- `statuses` 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
- `q` string
- `cursor` string
- `limit` integer

## Response `200`

Successful response

- PublicSituationList
  - `object` 'list', required
  - `data` PublicSituation[], required
    - `object` 'situation', required
    - `id` string, required
    - `publicId` string, required: Opaque 19-digit public share id. 1:1 with id and stable across reclassification.
    - `createdAt` string, required
    - `updatedAt` string, required
    - `type` string, required
    - `subtype` string
    - `status` string, required
    - `statusUpdatedAt` string, required
    - `ticker` string
    - `cik` string, required
    - `entityName` string, required
    - `exchange` string
    - `country` string
    - `sector` string
    - `headline` string, required
    - `summaryMd` string
    - `businessProfile` string
    - `terms` object
      - `counterparty` string
      - `counterpartyTicker` string
      - `stakePct` number
      - `dealValueUsd` number
      - `pricePerShare` number
      - `considerationType` string
      - `premiumPct` number
    - `keyDates` object
      - `announced` string
      - `record` string
      - `vote` string
      - `expiry` string
      - `expectedClose` string
      - `completed` string
      - `terminated` string
    - `market` object
      - `price` number
      - `marketCapUsd` number
      - `marketCapBucket` string
      - `enterpriseValueUsd` number
      - `asOf` string
    - `sourceAccessions` string[], required
    - `eventCount` integer, required
    - `latestEventAt` string
    - `publicProvenance` object, required
      - `source` 'sec.gov', required
      - `sourceFilings` object[], required
        - `accessionNumber` string, required
        - `filingUrl` string, uri
        - `formType` string
        - `filedAt` string
        - `title` string
      - `citations` object[], required
        - `claimPath` string, required
        - `claim` string, required
        - `accessionNumber` string, required
        - `filingUrl` string, uri
  - `hasMore` boolean, required
  - `nextCursor` string
  - `degradedState` unknown
  - `generatedAt` string, required
  - `asOf` string
  - `coverage` object
    - `scope` string
    - `window` string
    - `countedFields` string[]
    - `dimensions` object

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