---
title: "GET /access-preview#analyzerArn"
method: GET
path: "/access-preview#analyzerArn"
---

# GET /access-preview#analyzerArn

`GET /access-preview#analyzerArn`

Retrieves a list of access previews for the specified analyzer.

## Query parameters

- `analyzerArn` string, required
- `nextToken` string
- `maxResults` integer

## Response `200`

Success

- ListAccessPreviewsResponse
  - `accessPreviews` AccessPreviewSummary[], required — A list of access previews retrieved for the analyzer.
    - `id` string, required — The unique ID for the access preview.
    - `analyzerArn` string, required — The ARN of the analyzer used to generate the access preview.
    - `createdAt` string, date-time, required — The time at which the access preview was created.
    - `status` 'COMPLETED' | 'CREATING' | 'FAILED', required — <p>The status of the access preview.</p> <ul> <li> <p> <code>Creating</code> - The access preview creation is in progress.</p> </li> <li> <p> <code>Completed</code> - The access preview is complete and previews the findings for external access to the resource.</p> </li> <li> <p> <code>Failed</code> - The access preview creation has failed.</p> </li> </ul>
    - `statusReason` AccessPreviewStatusReason — Provides more details about the current status of the access preview. For example, if the creation of the access preview fails, a <code>Failed</code> status is returned. This failure can be due to an internal issue with the analysis or due to an invalid proposed resource configuration.
      - `code` 'INTERNAL_ERROR' | 'INVALID_CONFIGURATION', required — The reason code for the current status of the access preview.
  - `nextToken` string — A token used for pagination of results returned.

## Other responses

- `480` — ResourceNotFoundException
- `481` — ValidationException
- `482` — InternalServerException
- `483` — ThrottlingException
- `484` — AccessDeniedException

---

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