v1

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

Findings

List the data breach findings for a company.

List the data breach findings for a company. These findings might include Information Disclosure, Leak Credential, IP Reputation, Hacktivist Shares 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/databreach

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.

Information Disclosure
Credential Mgmt.
IP Reputation
Hacktivist Shares

Urlstring

The URL to get details of the finding.

For Information Disclosure module findings, the URL will point to https://app.blackkitetech.com/api/v2/companies/{id}/findings/informationdisclosure/{findingId}
For Credential Mgmt. module findings, the URL will point to https://app.blackkitetech.com/api/v2/companies/{id}/findings/credentialmanagement/{findingId}
For IP Reputation module findings, the URL will point to https://app.blackkitetech.com/api/v2/companies/{id}/findings/ipreputation/{findingId}
For Hacktivist Shares module findings, the URL will point to https://app.blackkitetech.com/api/v2/companies/{id}/findings/hacktivistshares/{findingId}

Example response

[
  {
    "FindingId": 2590965999,
    "Module": "Information Disclosure",
    "Url": "https://app.blackkitetech.com/api/v2/companies/22/findings/informationdisclosure/90965999"
  }
]