---
title: "POST /detector/{detectorId}/findings"
method: POST
path: "/detector/{detectorId}/findings"
---

# POST /detector/{detectorId}/findings

`POST /detector/{detectorId}/findings`

Lists Amazon GuardDuty findings for the specified detector ID.

## Path parameters

- `detectorId` string, required

## Query parameters

- `MaxResults` string
- `NextToken` string

## Request body

- object
  - `findingCriteria` object — Contains information about the criteria used for querying findings.
    - `Criterion` object — Represents a map of finding properties that match specified conditions and values when querying findings.
  - `sortCriteria` object — Contains information about the criteria used for sorting findings.
    - `AttributeName` string — Represents the finding attribute, such as <code>accountId</code>, that sorts the findings.
    - `OrderBy` 'ASC' | 'DESC' — The order by which the sorted findings are to be displayed.
  - `maxResults` integer — 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.
  - `nextToken` string — 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.

## Response `200`

Success

- ListFindingsResponse
  - `FindingIds` FindingId[], required — The IDs of the findings that you're listing.
  - `NextToken` string — The pagination parameter to be used on the next list operation to retrieve more items.

## Other responses

- `480` — BadRequestException
- `481` — InternalServerErrorException

---

[API](https://skmtc.net/aws/apis/guardduty.md) · [All operations](https://skmtc.net/aws/apis/guardduty/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/guardduty/versions/d35ef49b25a3/schema)