Security Performance Management
Continuous Monitoring
Cyber Insurance
National Cybersecurity

Articles in this section

GET: Vulnerability Alert Details

Avatar
Ingrid
Follow
Publication Date – August 8, 2019

⇤ Alerts

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.

Parameter Description Values 
alert_guid
Path		 Identify a Vulnerabilities and Infections [VULNERABILITY] alert to query. [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.

Related articles