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

# Public situations statistics

`GET /v1/embed/situations/stats`

## Request

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

Public recent-window Special Situations counts with persisted-column coverage scope.

## Response `200`

Successful response

- PublicSituationStats
  - `object` 'situation_stats', required
  - `asOf` string, required
  - `generatedAt` string
  - `lastSuccessfulRunAt` string
  - `window` string
  - `total` integer, required
  - `latestEventAt` string, nullable
  - `byType` object, required
  - `byStatus` object, required
  - `bySector` object
  - `byMarketCapBucket` object
  - `byCountry` object
  - `coverage` object
    - `scope` 'persisted_situation_columns', required
    - `countedFields` string[], required
    - `dimensions` object
      - `sector` object
        - `known` integer, required
        - `unknown` integer, required
        - `total` integer, required
        - `ratio` number, required
      - `marketCapBucket` object
        - `known` integer, required
        - `unknown` integer, required
        - `total` integer, required
        - `ratio` number, required
      - `country` object
        - `known` integer, required
        - `unknown` integer, required
        - `total` integer, required
        - `ratio` number, required
      - `currency` object
        - `known` integer, required
        - `unknown` integer, required
        - `total` integer, required
        - `ratio` number, required
    - `suppressedDimensions` object[]
      - `dimension` 'sector' | 'marketCapBucket' | 'country' | 'currency', required
      - `reason` 'not_enriched', 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)