GET: Threat Evidence – Bitsight Knowledge Base

https://api.bitsighttech.com/ratings/v1/threats/threat_guid/companies/company_guid/evidence

Get a company’s threat evidence details.

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 detection type.

[String]

exposure
mitigation

evidence_certainty

[Query] Filter by evidence certainty.

[String]

possible
likely
confirmed

exposure_detection

[Query] Filter by exposure detection status.

[String]

currently
previously

force_masked

[Query]

[Boolean]

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/company_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	For internal Bitsight use.
		certainty String	A measure of how certain Bitsight is about the company’s threat detection.
		exposure_detection String	The company's protection status from threats.
		detection_type String	The company's protection status from threats.
		first_seen_date String [`YYYY-MM-DD`]	The date when the threat was first seen.
		last_seen_date String [`YYYY-MM-DD`]	The date when the threat was last seen.

March 1, 2024: Published.

Parameters

Example Request

Example Response

Response Attributes

Related articles