GET: Findings Statistics

Jessica

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

Get findings statistics of a company.

Parameters
Example Response
Response Attributes

Parameters

* Required.

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

You may also use the query parameters listed in GET: Finding Details with this endpoint.

company_guid

* Required.

[Query] Identify the company to query.

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

fields

[Query] Filter by fields.

Value: [Array] Comma-separated field names, which are available in the response. The order of the specific fields might not be reflected in the response when using this parameter.

expand

[Query] Include additional information.

Value: [String]

first_seen_count = Include findings counts by first_seen
last_seen_count = Include findings counts by last_seen
active_count = Include active findings counts
resolved_count = Include resolved findings counts

This parameter is only available for this endpoint if you have Attack Surface Analytics.

Example Response

[
  {
    "start_date": "2022-12-01",
    "end_date": "2023-01-01",
    "count": 47,
    "first_seen_count": 1
    "last_seen_count": 1,
    "active_count": 0,
    "resolved_count": 0
  }
]

Response Attributes

Field	Description
start_date String [`YYYY‑MM‑DD`]	The start date of that period.
end_date String [`YYYY‑MM‑DD`]	The end date of that period.
count Integer	The number of findings in that period.
first_seen_count Integer	The number of findings first seen in that period.
last_seen_count Integer	The number of findings last seen in that period.
active_count Integer	The number of active findings in that period.
resolved_count Integer	The number of resolved findings in that period.

July 15, 2024: Published.