GET: Diligence Statistics

Ingrid

https://api.bitsighttech.com/ratings/v1/companies/company_guid/diligence/statistics

Get Diligence statistics of a company. The data includes:

The finding grade distribution of each risk vector.
Category distribution within the Domain Squatting risk vector.

Parameters

See query parameters for details on the format (value: json) parameter.

* Required.

company_guid

* Required.

[Path] Identify the company to query.

Value: [String] Company unique identifier [entity_guid]. See GET: Portfolio Details.

Example Request

curl https://api.bitsighttech.com/ratings/v1/companies/a940bb61-33c4-42c9-9231-c8194c305db3/diligence/statistics -u api_token:

Example Response

{
  "risk_vectors":{
    […]
    "desktop_software":{
      "unknown":0,
      "bad":9,
      "warn":20,
      "neutral":1,
      "fair":35,
      "good":62
    },
    "domain_squatting":{
      "spear_phishing":961,
      "bit_flip":611,
      "typographical_errors":2397,
      "tld_variant":27,
      "total_count":3996
    }
  }
}

Response Attributes

Field			Description
risk_vectors Object			Statistics by risk vector.
	Risk Vector Slug Name Object		A Diligence risk vector.
		unknown Integer	The number of unknown finding grades.
		bad Integer	The number of bad finding grades.
		warn Integer	The number of warn finding grades.
		neutral Integer	The number of neutral finding grades.
		fair Integer	The number of fair finding grades.
		good Integer	The number of good finding grades.
	domain_squatting Object		Statistics for the Domain Squatting risk vector.
		spear_phishing Integer	The number of domains found that are masquerading as being part of the organization, either directly or as a partner.
		bit_flip Integer	The number of domains found that flipped a bit for one of the characters.
		typographical_errors Integer	The number of domains found that could be reached if it was mis-typed by the user.
		tld_variant Integer	The number of domains found using variants of the top-level domain.
		total_count Integer	The number of Domain Squatting findings.

November 11, 2022: Domain Squatting details.
June 30, 2020: Published.