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

# Situation counts

`GET /v1/situations/stats`

## Request

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

Situation counts by type, status, sector, market-cap bucket, and country with coverage scope.

## Query parameters

- `window` string

## Response `200`

Successful response

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