---
title: "POST /findings"
method: POST
path: "/findings"
---

# POST /findings

`POST /findings`

Retrieves a subset of information about one or more findings.

## Query parameters

- `maxResults` string
- `nextToken` string

## Request body

- object
  - `findingCriteria` object — Specifies, as a map, one or more property-based conditions that filter the results of a query for findings.
    - `criterion` object — A condition that specifies the property, operator, and one or more values to use to filter the results.
  - `maxResults` integer — The maximum number of items to include in each page of the response.
  - `nextToken` string — The nextToken string that specifies which page of results to return in a paginated response.
  - `sortCriteria` object — Specifies criteria for sorting the results of a request for findings.
    - `attributeName` string — The name of the property to sort the results by. This value can be the name of any property that Amazon Macie defines for a finding.
    - `orderBy` 'ASC' | 'DESC' — The sort order to apply to the results, based on the value for the property specified by the attributeName property. Valid values are: ASC, sort the results in ascending order; and, DESC, sort the results in descending order.

## Response `200`

Success

- ListFindingsResponse
  - `findingIds` String[] — An array of strings, where each string is the unique identifier for a finding that matches the filter criteria specified in the request.
  - `nextToken` string — The string to use in a subsequent request to get the next page of results in a paginated response. This value is null if there are no additional pages.

## Other responses

- `480` — ValidationException
- `481` — InternalServerException
- `482` — ServiceQuotaExceededException
- `483` — AccessDeniedException
- `484` — ResourceNotFoundException
- `485` — ThrottlingException
- `486` — ConflictException

---

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