---
title: "Get the finding stats of a company."
method: GET
path: "/api/v2/companies/{id}/findings/stats"
tags: ["Findings"]
---

# Get the finding stats of a company.

`GET /api/v2/companies/{id}/findings/stats`

Returns the count of active findings grouped by severity (Critical, High, Medium, Low) and status (Failed, Warning, Passed), matching the same data shown by the Findings Heatmap widget in the Black Kite platform. If start_date and end_date are both provided, only findings first discovered within that range are counted; the range can be maximum 365 days apart. If both are omitted, all-time stats are returned. Leaked credential findings are collapsed into a single Failed entry at their highest severity, consistent with the platform UI.

## Path parameters

- `id` integer, required

## Query parameters

- `start_date` string, date-time
- `end_date` string, date-time

## Response `200`

Success

- FindingStats
  - `Critical_Failed` integer — The number of active Critical severity findings with a Failed status.
  - `Critical_Warning` integer — The number of active Critical severity findings with a Warning status.
  - `Critical_Passed` integer — The number of active Critical severity findings with a Passed status.
  - `High_Failed` integer — The number of active High severity findings with a Failed status.
  - `High_Warning` integer — The number of active High severity findings with a Warning status.
  - `High_Passed` integer — The number of active High severity findings with a Passed status.
  - `Medium_Failed` integer — The number of active Medium severity findings with a Failed status.
  - `Medium_Warning` integer — The number of active Medium severity findings with a Warning status.
  - `Medium_Passed` integer — The number of active Medium severity findings with a Passed status.
  - `Low_Failed` integer — The number of active Low severity findings with a Failed status.
  - `Low_Warning` integer — The number of active Low severity findings with a Warning status.
  - `Low_Passed` integer — The number of active Low severity findings with a Passed status.

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `default` — Failure

---

[API](https://skmtc.net/blackkitetech/apis/black-kite-api.md) · [All operations](https://skmtc.net/blackkitetech/apis/black-kite-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blackkitetech/black-kite-api/revisions/616dfa9b3b1f/schema)