GET: Statistics

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

Get Compromised Systems statistics of a company during the past 1 year. The data includes:

• The number of findings by risk vector.
• The average event duration in days.

Parameters

* Required.

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

company_guid

* Required.

[Path] Identify the company to query.

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

include_durations

[Query] Determine if event duration should be included.

Value: [Boolean]

• true = Include event duration.
• ↻ false = Exclude event duration.

include_patching_cadence

[Query] Determine if Patching Cadence data should be included.

Value: [Boolean]

• true = Include Patching Cadence data.
• ↻ false = Exclude Patching Cadence data.

Example Request

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

Example Response

{
  "risk_vectors":{
    […]
    "potentially_exploited":{
      "count":25,
      "count_period":"year",
      "average_duration_days":2.1
    }
  }
}

Response Attributes

risk_vectors

count

count_period

average_duration_days

Status Codes

See common errors and status codes.

200 – Okay

Everything worked as expected.