---
title: "GET /v2/list-reports"
method: GET
path: "/v2/list-reports"
---

# GET /v2/list-reports

`GET /v2/list-reports`

List reports for a service, or all reports owned by the account if serviceArn is not provided.

## Query parameters

- `serviceArn` string — ARN identifier.
- `reportType` 'FAILURE_MODE'
- `maxResults` integer — Pagination page size.
- `nextToken` string — Pagination token.

## Response `200`

Success

- ListReportsResponse
  - `reportGenerationResults` ReportGenerationResult[], required — The list of report generation results.
    - `reportType` 'FAILURE_MODE', required — The type of the generated report.
    - `status` 'PENDING' | 'SUCCEEDED' | 'FAILED', required — The status of the report generation.
    - `serviceArn` string — The service this report was generated for.
    - `assessmentId` string — Present for FAILURE_MODE reports.
    - `createdAt` string, date-time — The timestamp when the report was created.
    - `reportOutput` object — Present when status is SUCCEEDED or FAILED.
      - `s3ReportOutput` object — The S3 location where the report was written.
        - `s3ObjectKey` string, required — The S3 object key for the generated report.
      - `failedReportOutput` object — Details when report generation failed.
        - `errorCode` 'INSUFFICIENT_PERMISSIONS' | 'CONFIGURATION_ERROR' | 'INTERNAL_ERROR', required — The error code describing why the report generation failed.
        - `errorMessage` string — The error message describing why the report generation failed.
  - `nextToken` string — Pagination token.

## Other responses

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

---

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