Sign in

v1

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

List the first seen (new) and/or updated findings in a given date range for a company.

List the first seen (new) and/or updated findings in a given date range for a company. Date range can be maximum 15 days apart. Beware that the response contains the current status of the finding. So, for example, a returned finding might be first seen between the given date range, however, it might also be updated to be fixed between the same date range. Also beware that this endpoint might throw HTTP 524 Timeouts under heavy traffic when high page sizes are being used. If so, please try lowering page sizes and retry again. <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

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.

start_datestring date-time required
Example:2023-08-01T08:30:30.682Z

The beginning of the date range in which the findings were found. Start date must be older than end date.

end_datestring date-time required
Example:2023-08-04T08:30:30.682Z

The end of the date range in which the findings were found. End date must be newer than start date. Make sure the difference between end_date and start_date is 15 days at most.

type'New' | 'Updated' | 'All' required
Example:New

The type of findings. Possible values are; New, Updated and All.

Response

Success

Modulestring

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

  • DNS Health
  • Email Security
  • SSL/TLS Strength
  • Application Security
  • DDoS Resiliency
  • Network Security
  • Fraudulent Domains
  • Fraudulent Apps
  • Credential Mgmt.
  • IP Reputation
  • Hacktivist Shares
  • Social Network
  • Attack Surface
  • Brand Monitoring
  • Patch Management
  • Web Ranking
  • Information Disclosure
  • CDN Security
  • Website Security
FindingIdinteger

The unique identifier of this 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.
FirstSeenDatestring date-time

The date that the finding was found.

UpdateDatestring date-time

The last date that the finding was updated. If the UpdateDate equals to the FirstSeenDate or the UpdateDate is null that means the finding is NEW, otherwise the finding is UPDATED.

Example response

[
  {
    "Module": "Email Security",
    "FindingId": 2590965999,
    "Status": "Active",
    "FirstSeenDate": "2023-08-01T08:30:30.682Z",
    "UpdateDate": "2023-08-01T08:30:30.682Z"
  }
]