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

# Get a patch management finding of a company.

`GET /api/v2/companies/{id}/findings/patchmanagement/{findingId}`

Company asset system versions are collected from internet-wide scanners like Censys, Shodan, Zoomeye etc. These version numbers are converted into the corresponding common platform enumeration number (CPE-ID) and are correlated with NIST NVD and MITRE CVSS databases to detect and approximate any unmitigated known vulnerabilities.<br/><br/> For storage optimization, the system <b>permanently</b> deletes all findings that haven't been detected by the Black Kite scanner for over a year. Findings with manually changed statuses or associated tickets are excluded.

## Path parameters

- `id` integer, required
- `findingId` integer, required

## Query parameters

- `exclude_fields` string

## Response `200`

Success

- PatchManagementFinding
  - `FindingId` integer — The unique identifier of this finding.
  - `Domain` string — The domain which this finding is related.
  - `IPAddress` string — The related IP address which contains the finding.
  - `Subdomain` string, nullable — The related subdomain which contains the finding. This field may be empty.
  - `Severity` 'Info' | 'Low' | 'Medium' | 'High' | 'Critical' — The severity of a finding.
  - `Status` 'Active' | 'FalsePositive' | 'Suppressed' | 'Acknowledged' | 'Deleted' | 'Remediated' — The status of this finding. - Active, means the finding is still active with no review as of yet. - FalsePositive, means the finding is considered to be false alarm. - Suppressed, means the finding is suppressed, similar to FalsePositive. - Acknowledged, means the finding is accepted, for example will not be fixed. - Deleted, means the finding is deleted, similar to FalsePositive. - Remediated, means the finding is mitigated.
  - `ProductName` string — The name of the product that needs the patch.
  - `PublishDate` string, date-time, nullable — The date of the related patch was published.
  - `FindingDate` string, date-time — The date that Black Kite first seen the finding.
  - `LastCheckDate` string, date-time — The date that Black Kite last checked the finding.
  - `ControlId` string — The unique identifier of the control that this finding relates to.
  - `CvssScore` number, float, nullable — The Common Vulnerability Scoring System score of the finding.
  - `CwssScore` number, float, nullable — The Common Weakness Scoring System score of the finding.
  - `Ticket` FindingTicketSummary — A summary information of a finding ticket.
    - `TicketId` number, nullable — The unique identifier of the ticket.
    - `Status` 'Unassigned' | 'Assigned' | 'In Progress' | 'Closed–Acknowledged' | 'Closed–Remediated' | 'Closed–False Positive' | 'On Hold' | 'Recheck' | 'Deleted' — The status of this ticket. A ticket is automatically in “Assigned” status when a user with admin rights assigns it to another user. Depending on the user type, tickets can have different statuses: In Progress, On Hold and Recheck. - Unassigned: No owner has been set; the ticket is pending assignment. - In progress: Means the user takes responsibility of the associated finding and in the remediation process. - On hold: Means the user is waiting for another action to be completed before s/he takes action with regards to the finding. - Recheck: Means the user has completed her/his progress about the finding and waits for the user who assigns the ticket (or follow-up user with admin rights) to close it. An admin user can set a ticket in seven different statuses, In Progress, On Hold, Recheck, Closed-Acknowledged, Closed-Remediated, Closed-False Positive, and Deleted. - Closed-Acknowledged: The definition is very similar to risk acceptance. This means no or limited action can be taken with regards to the finding. There is no way but to accept the risk of the finding. This could be due to an out-of-date system soon to be retired. - Closed–Remediated: The action right after the Recheck status. If a company user sets the ticket in Recheck status, it is then passed to the admin user for him/her to close the issue. Closed status means the issue is fixed. - Closed-False Positive: Indicates a reported issue was a false alarm upon investigation. No action needed, as it poses no genuine risk. - Deleted: As the name suggests, this deletes the ticket (not the finding). It does not necessarily mean the issue is fixed or risk is accepted.
    - `Owner` string, nullable — A ticket may have one or more owners. But this field contains the name or the email address of the first one.
  - `CveId` string, nullable — The related CVE id of the finding.
  - `CweId` string, nullable — The related CWE id of the finding.
  - `Detail` string — A short detail specific to the finding. Possibly HTML formatted.
  - `Title` string — A title for the finding. Same with the security control's title referenced by the ControlId.
  - `References` string[], nullable
  - `Cpes` string[] — A list of related CPEs.
  - `Port` number, nullable — The port number of asset(s)
  - `Epss` number, float, nullable — Given score to the CveId that related to the relevant finding, by the Exploit Prediction Scoring System.
  - `InKev` boolean, nullable — Indicates whether the CveId related to the relevant finding is one of the known exploited vulnerabilities (KEV) based on CISA’s KEV catalog.
  - `Tags` TagOfFinding[]
    - `Id` integer
    - `Name` string
  - `Output` 'Failed' — The output field in PatchManagement findings works differently from other findings. All findings are treated as "Failed".
  - `ConfidenceLevel` 'Low' | 'Medium' | 'High' | 'VeryHigh', nullable — The confidence level of this finding.
  - `UpdateDate` string, date-time, nullable — The date that the finding was last updated.
  - `IsRsiFinding` boolean — Indicates whether this finding contributes to the company's Ransomware Susceptibility Index (RSI) score.

## Other responses

- `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/versions/7dadaba760fb/schema)