v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14139565.0 KB

Returns metrics about all findings in an account within a specified time range.

get/metrics/findings#startDate&endDate

Query parameters

nextTokenstring

A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the <code>nextToken</code> value returned from the previous request to continue listing results after the first page.

maxResultsinteger

The maximum number of results to return in the response. Use this parameter when paginating results. If additional results exist beyond the number you specify, the <code>nextToken</code> element is returned in the response. Use <code>nextToken</code> in a subsequent request to retrieve additional results. If not specified, returns 1000 results.

startDatestring date-time required

The start date of the interval which you want to retrieve metrics from. Rounds to the nearest day.

endDatestring date-time required

The end date of the interval which you want to retrieve metrics from. Round to the nearest day.

Response

Success

nextTokenstring

A pagination token. You can use this in future calls to <code>ListFindingMetrics</code> to continue listing results after the current page.