---
title: "GET /allow-lists"
method: GET
path: "/allow-lists"
---

# GET /allow-lists

`GET /allow-lists`

Retrieves a subset of information about all the allow lists for an account.

## Query parameters

- `maxResults` integer
- `nextToken` string

## Response `200`

Success

- ListAllowListsResponse
  - `allowLists` AllowListSummary[] — An array of objects, one for each allow list.
    - `arn` string — The Amazon Resource Name (ARN) of the allow list.
    - `createdAt` string, date-time — The date and time, in UTC and extended ISO 8601 format, when the allow list was created in Amazon Macie.
    - `description` string — The custom description of the allow list.
    - `id` string — The unique identifier for the allow list.
    - `name` string — The custom name of the allow list.
    - `updatedAt` string, date-time — The date and time, in UTC and extended ISO 8601 format, when the allow list's settings were most recently changed in Amazon Macie.
  - `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` — ThrottlingException
- `481` — ValidationException
- `482` — InternalServerException
- `483` — AccessDeniedException

---

[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)