---
title: "GET /v2/email/deliverability-dashboard/test-reports"
method: GET
path: "/v2/email/deliverability-dashboard/test-reports"
---

# GET /v2/email/deliverability-dashboard/test-reports

`GET /v2/email/deliverability-dashboard/test-reports`

Show a list of the predictive inbox placement tests that you've performed, regardless of their statuses. For predictive inbox placement tests that are complete, you can use the <code>GetDeliverabilityTestReport</code> operation to view the results.

## Query parameters

- `NextToken` string
- `PageSize` integer

## Response `200`

Success

- ListDeliverabilityTestReportsResponse — A list of the predictive inbox placement test reports that are available for your account, regardless of whether or not those tests are complete.
  - `DeliverabilityTestReports` DeliverabilityTestReport[], required — An object that contains a lists of predictive inbox placement tests that you've performed.
    - `ReportId` string — A unique string that identifies the predictive inbox placement test.
    - `ReportName` string — A name that helps you identify a predictive inbox placement test report.
    - `Subject` string — The subject line for an email that you submitted in a predictive inbox placement test.
    - `FromEmailAddress` string — The sender address that you specified for the predictive inbox placement test.
    - `CreateDate` string, date-time — The date and time when the predictive inbox placement test was created.
    - `DeliverabilityTestStatus` 'IN_PROGRESS' | 'COMPLETED' — The status of the predictive inbox placement test. If the status is <code>IN_PROGRESS</code>, then the predictive inbox placement test is currently running. Predictive inbox placement tests are usually complete within 24 hours of creating the test. If the status is <code>COMPLETE</code>, then the test is finished, and you can use the <code>GetDeliverabilityTestReport</code> to view the results of the test.
  - `NextToken` string — A token that indicates that there are additional predictive inbox placement tests to list. To view additional predictive inbox placement tests, issue another request to <code>ListDeliverabilityTestReports</code>, and pass this token in the <code>NextToken</code> parameter.

## Other responses

- `480` — TooManyRequestsException
- `481` — NotFoundException
- `482` — BadRequestException

---

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