v1

latestOpenAPI 3.0.0Proprietary - Commercial Use Only2026-08-06172139621.6 KB

Findings

List the ransomware findings for a company.

List the ransomware findings for a company. These findings might include Network Security, Patch Management, Credential Mgmt., Fraudulent Domains, IP Reputation, Information Disclosure, Hacktivist Shares, Email Security module findings.<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.

get/api/v2/companies/{id}/findings/ransomware

Path parameters

idinteger required

The id of the target company.

Query parameters

page_numberinteger

Example:1

The number of the page requested.

page_size10 | 20 | 30 | 50 | 100 | 250 | 500 | 1000 | 5000

Example:10

The number of result items in a single response.

Response

Success

FindingIdinteger

The unique identifier of this finding.

Modulestring

The module of this finding. The possible responses are listed below.

Network Security
Patch Management
Credential Mgmt.
Fraudulent Domains
IP Reputation
Information Disclosure
Hacktivist Shares
Email Security

Urlstring

The URL to get details of the finding.

For Network Security module findings, the URL will point to https://app.blackkitetech.com/api/v2/companies/{id}/findings/networksecurity/{findingId}
For Patch Management module findings, the URL will point to https://app.blackkitetech.com/api/v2/companies/{id}/findings/patchmanagement/{findingId}
For Credential Mgmt. module findings, the URL will point to https://app.blackkitetech.com/api/v2/companies/{id}/findings/credentialmanagement/{findingId}
For Fraudulent Domains module findings, the URL will point to https://app.blackkitetech.com/api/v2/companies/{id}/findings/fraudulentdomains/{findingId}
For IP Reputation module findings, the URL will point to https://app.blackkitetech.com/api/v2/companies/{id}/findings/ipreputation/{findingId}
For Information Disclosure module findings, the URL will point to https://app.blackkitetech.com/api/v2/companies/{id}/findings/informationdisclosure/{findingId}
For Hacktivist Shares module findings, the URL will point to https://app.blackkitetech.com/api/v2/companies/{id}/findings/hacktivistshares/{findingId}
For Email Security module findings, the URL will point to https://app.blackkitetech.com/api/v2/companies/{id}/findings/emailsecurity/{findingId}

Example response

[
  {
    "FindingId": 2590965999,
    "Module": "Network Security",
    "Url": "https://app.blackkitetech.com/api/v2/companies/22/findings/networksecurity/90965999"
  }
]