GET: Vulnerability Alert Details

Ingrid

https://api.bitsighttech.com/ratings/v1/alerts/vulnerability/alert_guid

Use this path to get the details of a vulnerability and infections alert. The Vulnerabilities and Infections alert category allows you to filter and get alerts on infections and vulnerabilities that affect companies in your portfolio.

Only available if the Vulnerabilities and Infections alert is enabled.
Not available for Risk Monitoring, National Cybersecurity, and Applicants subscriptions.

Parameters

See all available parameters.

* Required.

alert_guid

* Required.

[Path] Identify a Vulnerabilities and Infections [VULNERABILITY] alert to query.

Value: [String] Alert unique identifier [alert_guid]. See GET: Alerts.

Example Request

curl https://api.bitsighttech.com/ratings/v1/alerts/vulnerability/1234567890 -u api_token:

Example Response

{
  "guid":1234567890,
  "alert_date":"1980-03-28",
  "company_name":"Example Company",
  "company_guid":"dd231077-fb19-46ba-9dd0-0884c8d48624",
  "start_date":"1981-06-09",
  "folder_guid":"a1c5a0d5-6226-45c4-897d-e9c9144bff98",
  "company_url":"/company/dd231077-fb19-46ba-9dd0-0884c8d48624/",
  "alert_type":"VULNERABILITY",
  "alert_severity":null,
  "message":"Unsupported version of OpenSSH software detected."
}

Response Attributes

Field	Description
guid String [`alert_guid`]	The unique identifier of this alert.
alert_date String [`YYYY‑MM‑DD`]	The date when this alert was generated.
company_name String	The name of the company that triggered this alert.
company_guid String [`entity_guid`]	The unique identifier of the company associated with this alert.
start_date String [`YYYY‑MM‑DD`]	The start date of the alert period.
folder_guid String [`folder_guid`]	The unique identifier of the folder where this alert was created. This is your “All Companies” folder if the company was not in a specific folder.
company_url String	The URL path to this company’s overview page in the Bitsight platform.
alert_type String	The condition that triggered this alert. See alert categories.
alert_severity String	The level of change that generated this alert. The “`VULNERABILITY`” alert category is always “`INFORMATIONAL`.” See change severity.
message String	A description of the vulnerability or infection that triggered this alert.

August 8, 2019: Published.