Findings Remediation API Guide – Bitsight Knowledge Base

July 10, 2023: Removed PDF.
August 23, 2021: Removed GET /v1/companies/company_guid}/assets/findings .
August 24, 2020: Published.

Get an understanding of your findings and track your remediation efforts.

Endpoints

Path	Purpose	Description
/v1/companies/company_guid/assets/statistics	GET: Asset Risk Matrix	Get the counts and the severity of security findings for a given company. This includes findings that were observed within the last 60 days.
/v1/companies/company_guid/findings	GET: Finding Details	Get an organization’s finding details.
/v1/companies/company_guid/observations	GET: Detailed Company Observations	Retrieve detailed information (observations) about the risk category data of companies in your portfolio. The information is similar to what is shown on the Forensics view of a security rating report, but includes Compromised Systems, Diligence, and User Behavior. Observations do not all necessarily impact the company’s rating.

Path	Purpose	Description
/v1/remediations	GET: Remediation Tracking	Track your remediation efforts with Issue Tracking for Remediation.
/v1/remediations	POST: Track the Remediation of a Finding	Manage your findings for remediation tracking and assign users to remediate.
/v1/remediations	PATCH: Update the Status or Assignee of a Finding	Manage the remediation status or user assigned to findings.

Path	Purpose	Description
/v2/users	GET: Users	Get a list of all the users within your account to assign them to remediate a finding.

Path	Purpose	Description
/v1/findings/wfh	GET: Work From Home Findings	Use Work From Home (WFH) to get findings for a set of IP addresses.