---
title: "GET /ab-tests"
method: GET
path: "/ab-tests"
---

# GET /ab-tests

`GET /ab-tests`

Lists all A/B tests in the account.

## Query parameters

- `maxResults` integer
- `nextToken` string

## Response `200`

Success

- ListABTestsResponse
  - `abTests` ABTestSummary[], required — The list of A/B test summaries.
    - `abTestId` string, required — The unique identifier of the A/B test.
    - `abTestArn` string, required — The Amazon Resource Name (ARN) of the A/B test.
    - `name` string, required — The name of the A/B test.
    - `status` 'CREATING' | 'ACTIVE' | 'CREATE_FAILED' | 'UPDATING' | 'UPDATE_FAILED' | 'DELETING' | 'DELETE_FAILED' | 'FAILED', required — The current status of the A/B test.
    - `executionStatus` 'PAUSED' | 'RUNNING' | 'STOPPED' | 'NOT_STARTED', required — The execution status of the A/B test.
    - `description` string — The description of the A/B test.
    - `gatewayArn` string — The Amazon Resource Name (ARN) of the gateway used for traffic splitting.
    - `createdAt` string, date-time, required — The timestamp when the A/B test was created.
    - `updatedAt` string, date-time, required — The timestamp when the A/B test was last updated.
  - `nextToken` string — If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.

## Other responses

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

---

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