Skip to main content

GET /cspm/finding_changes_overview

This API returns a count of new, resolved, and modified findings detected within a specified date range on the scan accounts in your company.

Request

Format

GET /cspm/finding_changes_overview?from_date=<string>&to_date=<string>&severities=<string>&scans=<string>&scan_groups=<string>&rules=<string>&resources=<string>&system_compliance=<string>

Parameters

Parameter

Type

Optional

Description

from_date

String

No

The start date and time of the request interval, in ISO 8601 format. The from_date may not be more than 90 days before the current date and time.

to_date

String

Yes

The end date and time of the request interval, in ISO 8601 format. If you do not include this parameter in the request, the current date and time are used by default.

severities

Array of strings

Yes

Only return information for findings with the specified severity levels. You can enter multiple comma-separated values. Possible values: informational, low, medium, high, critical.

scans

Array of strings

Yes

Only return information for the specified scan account IDs. You can enter multiple comma-separated values.

scan_groups

Array of strings

Yes

Only return information for the specified scan group IDs. You can enter multiple comma-separated values.

rules

Array of strings

Yes

Only return information for findings associated with the specified rule IDs. You can enter multiple comma-separated values.

resources

Array of strings

Yes

Only return information for findings that involve the specified resource IDs. You can enter multiple comma-separated values.

system_compliance

Array of strings

Yes

Only return information for findings associated with the specified compliance standard IDs. You can enter multiple comma-separated values.

Examples

Return information on changes for critical severity findings, recorded for the scan group with ID 27bd7e86-6569-46b7-9e1a-defe95******, within the interval from April 20, 2026, to April 28, 2026:

GET /cspm/finding_changes_overview?from_date=2026-04-20&to_date=2026-04-28&severities=critical&scan_groups=27bd7e86-6569-46b7-9e1a-defe95******

Response

Format

{
    "data": {
        "new_count": 48,
        "resolved_count": 21,
        "modified_count": 6
    }
}

Attributes

This endpoint returns an object containing multiple attributes:

Attribute

Type

Description

data

Object

Data on the finding changes

    new_count

Integer

The total number of finding changes of the new type for the time interval and filtering criteria specified in the request.

    resolved_count

Integer

The total number of finding changes of the resolved type for the time interval and filtering criteria specified in the request.

    modified_count

Integer

The total number of finding changes of the modified type for the time interval and filtering criteria specified in the request.

Example

{
    "data": {
        "new_count": 128,
        "resolved_count": 36,
        "modified_count": 9
    }
}
In this section: