https://api.bitsighttech.com/ratings/v1/threats/threat_guid/companies/entity_guid/evidence
Get a company’s threat (such as vulnerabilities) evidence details.
Version 2 is now available.
Parameters
* Required.
See query parameters for details on the following parameters:
format
-
limit
(Default: ↻10
) -
offset
(Default: ↻0
) q
Parameter | Values | |
---|---|---|
company_guid * [Path] Identify the company to query. |
[String] Company unique identifier [entity_guid ]. See GET: Portfolio Details. |
|
Date Filters | [String] The date [YYYY-MM-DD ]. |
|
first_seen_date_gte [Query] Filter by threats that were first seen on and after a certain date. |
||
first_seen_date_lte [Query] Filter by threats that were first seen on and before a certain date. |
||
last_seen_date_gte [Query] Filter by threats that were last seen on and after a certain date. |
||
last_seen_date_lte [Query] Filter by threats that were last seen on and before a certain date. |
||
detection_type [Query] Filter by exposure detection. |
[String]
|
|
evidence_certainty [Query] Filter by evidence certainty. |
[String]
|
|
exposure_detection [Query] Filter by exposure detection status. |
[String]
|
|
force_masked [Query] Mask the IP address. If the entity has opted-out of Manage IP Visibility, the IP is masked regardless of this setting . |
[Boolean] true = Mask the IP address. |
|
sort [Query] |
[String] ↻ identifier (default) |
|
threat_guid * [Path] |
[String] Threat unique identifier [threat_guid ]. See GET: Portfolio Threats. |
Example Request
curl https://api.bitsighttech.com/ratings/v1/threats/threat_guid/companies/entity_guid/evidence -u api_token:
Example Response
{ "links": { "previous": "string", "next": "string" }, "count": 0, "results": [ { "identifier": "string", "certainty": "string", "exposure_detection": "string", "detection_type": "string", "first_seen_date": "string", "last_seen_date": "string" } ] }
Response Attributes
Field | Description | ||
---|---|---|---|
links Object |
Navigation for multiple pages of results. See pagination. | ||
previous String |
The URL for navigating to the previous page of results. | ||
next String |
The URL for navigating to the next page of results. | ||
count Integer |
The number of threats on this company. | ||
results Array |
Threats and their details. | ||
Object | A threat. | ||
identifier String |
Identifies the asset that the threat is associated with. | ||
certainty String |
A measure of how certain Bitsight is about the company’s threat detection. | ||
exposure_detection String |
The company's exposure detection status from threats. | ||
detection_type String |
How the data was collected.
|
||
first_seen_date String [ |
The date when the threat was first seen. | ||
last_seen_date String [ |
The date when the threat was last seen. |
- October 18, 2024: Version is now available.
- March 1, 2024: Published.
Feedback
0 comments
Please sign in to leave a comment.