---
title: "Get Severity History"
method: GET
path: "/v1/findings/severity-score-history"
tags: ["Analytics"]
---

# Get Severity History

`GET /v1/findings/severity-score-history`

## Request

- Base URL: `https://api.mindfort.app`
- URL: `https://api.mindfort.app/v1/findings/severity-score-history`
- Auth: HTTP bearer

Returns a time series of severity scores at the chosen granularity, for your organization or a single target.

## Query parameters

- `target_id` string, uuid
- `granularity` 'day' | 'week' | 'month'

## Response `200`

Successful response

- PublicSeverityHistory
  - `target_id` string, uuid, nullable
  - `granularity` 'day' | 'week' | 'month', required
  - `data` SeverityScoreTimePoint[], required
    - `date` string, date-time, required
    - `average_severity_score` number, required
    - `finding_count` integer, required
    - `assessment_count` integer, required: Distinct linked assessments in the bucket. This can be zero when the bucket contains orphan findings without an assessment_id.

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key
- `403`: Not permitted for this organization
- `404`: Resource not found

---

[API](https://skmtc.dev/mindfort/apis/mindfort-api.md) - [All operations](https://skmtc.dev/mindfort/apis/mindfort-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mindfort/apis/mindfort-api/revisions/cb93bd79eebe?raw)