POST

/detector/{detectorId}/findings

http://guardduty.{region}.amazonaws.com/detector/{detectorId}/findings

Lists Amazon GuardDuty findings for the specified detector ID.

Access Token Required: API Key

Path Parameters

detectorIdstringrequired

The ID of the detector that specifies the GuardDuty service whose findings you want to list.

Query Params

MaxResultsstring

Pagination limit

NextTokenstring

Pagination token

Body Params

nextTokenstring

You can use this parameter when paginating results. Set the value of this parameter to null on your first call to the list action. For subsequent calls to the action, fill nextToken in the request with the value of NextToken from the previous response to continue listing data.

maxResultsinteger

You can use this parameter to indicate the maximum number of items you want in the response. The default value is 50. The maximum value is 50.

sortCriteriaobject

Contains information about the criteria used for sorting findings.

findingCriteriaobject

Contains information about the criteria used for querying findings.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'http://guardduty.{region}.amazonaws.com/detector/{detectorId}/findings' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}