---
title: "GET /audit/report-jobs"
method: GET
path: "/audit/report-jobs"
---

# GET /audit/report-jobs

`GET /audit/report-jobs`

Returns details about your report jobs.

## Query parameters

- `ReportPlanName` string
- `CreationBefore` string, date-time
- `CreationAfter` string, date-time
- `Status` string
- `MaxResults` integer
- `NextToken` string

## Response `200`

Success

- ListReportJobsOutput
  - `ReportJobs` ReportJob[] — Details about your report jobs in JSON format.
    - `ReportJobId` string — The identifier for a report job. A unique, randomly generated, Unicode, UTF-8 encoded string that is at most 1,024 bytes long. Report job IDs cannot be edited.
    - `ReportPlanArn` string — An Amazon Resource Name (ARN) that uniquely identifies a resource. The format of the ARN depends on the resource type.
    - `ReportTemplate` string — <p>Identifies the report template for the report. Reports are built using a report template. The report templates are: </p> <p> <code>RESOURCE_COMPLIANCE_REPORT | CONTROL_COMPLIANCE_REPORT | BACKUP_JOB_REPORT | COPY_JOB_REPORT | RESTORE_JOB_REPORT</code> </p>
    - `CreationTime` string, date-time — The date and time that a report job is created, in Unix format and Coordinated Universal Time (UTC). The value of <code>CreationTime</code> is accurate to milliseconds. For example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087 AM.
    - `CompletionTime` string, date-time — The date and time that a report job is completed, in Unix format and Coordinated Universal Time (UTC). The value of <code>CompletionTime</code> is accurate to milliseconds. For example, the value 1516925490.087 represents Friday, January 26, 2018 12:11:30.087 AM.
    - `Status` string — <p>The status of a report job. The statuses are:</p> <p> <code>CREATED | RUNNING | COMPLETED | FAILED</code> </p> <p> <code>COMPLETED</code> means that the report is available for your review at your designated destination. If the status is <code>FAILED</code>, review the <code>StatusMessage</code> for the reason.</p>
    - `StatusMessage` string — A message explaining the status of the report job.
    - `ReportDestination` object — The S3 bucket name and S3 keys for the destination where the report job publishes the report.
      - `S3BucketName` string — The unique name of the Amazon S3 bucket that receives your reports.
      - `S3Keys` String[] — The object key that uniquely identifies your reports in your S3 bucket.
  - `NextToken` string — An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.

## Other responses

- `480` — InvalidParameterValueException
- `481` — ServiceUnavailableException
- `482` — ResourceNotFoundException

---

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