Skip to main content
GET
/
api
/
v2
/
attack-paths
/
finding-trends
List finding trends
curl --request GET \
  --url https://your-tenant.bloodhoundenterprise.io/api/v2/attack-paths/finding-trends \
  --header 'Authorization: Bearer <token>'
{
  "start": "2023-11-07T05:31:56Z",
  "end": "2023-11-07T05:31:56Z",
  "environments": [
    "<string>"
  ],
  "data": {
    "findings": [
      {
        "environment_ids": [
          "<string>"
        ],
        "finding": "<string>",
        "display_title": "<string>",
        "display_type": "<string>",
        "composite_risk": 123,
        "finding_count_start": 123,
        "finding_count_end": 123,
        "finding_count_increase": 123,
        "finding_count_decrease": 123,
        "finding_impact_count": 123,
        "finding_exposure_count": 123
      }
    ],
    "total_finding_count_start": 123,
    "total_finding_count_end": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://specterops-fetch-json-component.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Applies to BloodHound Enterprise only

Authorizations

​
Authorization
string
header
required

Authorization: Bearer $JWT_TOKEN

Headers

​
Prefer
string
default:wait=30

Prefer header, used to specify a custom timeout in seconds using the wait parameter as per RFC7240. Passing in wait=-1 bypasses all timeout limits when the feature is enabled.

Pattern: ^wait=(-1|[0-9]+)$

Query Parameters

​
environments
string[]
required

Environment IDs

​
start
string<date-time>

Beginning datetime of range (inclusive) in RFC-3339 format; Defaults to current datetime minus 30 days

​
end
string<date-time>

Ending datetime of range (exclusive) in RFC-3339 format; Defaults to current datetime

​
asset_group_tag_id
integer

The asset group tag id of the zone requested. If not supplied, the asset group tag id associated with 'Tier Zero' and 'Hygiene' is used.

Response

OK

​
start
string<date-time>

The RFC-3339 timestamp to describe the beginning of a time range

​
end
string<date-time>

The RFC-3339 timestamp to describe the end of a time range

​
environments
string[]
​
data
object