GET: User Behavior Statistics

https://api.bitsighttech.com/ratings/v1/companies/company_guid/user-behavior/statistics

Get User Behavior statistics of a company. The data includes:

• The number of incidents grouped by file sharing category.
• The number of affected IP addresses.
• The number of hashes.

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/user-behavior/statistics'

Example Response

{
  "risk_vectors":{
    "file_sharing":{
      "incidents":108,
      "ips":2,
      "hashes":97,
      "stats":{
        […]
        "OTHER":{
          "incidents":22,
          "ips":2,
          "hashes":20
        }
      }
    }
  }
}

Response Attributes

risk_vectors

file_sharing

incidents

ips

hashes

stats

incidents

ips

hashes