---
title: "GET /ab-tests/{abTestId}"
method: GET
path: "/ab-tests/{abTestId}"
---

# GET /ab-tests/{abTestId}

`GET /ab-tests/{abTestId}`

Retrieves detailed information about an A/B test, including its configuration, status, and statistical results.

## Path parameters

- `abTestId` string, required

## Response `200`

Success

- GetABTestResponse
  - `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.
  - `description` string — The description 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 indicating whether the A/B test is currently running.
  - `gatewayArn` string, required — The Amazon Resource Name (ARN) of the gateway used for traffic splitting.
  - `variants` Variant[], required — The list of variants in the A/B test.
    - `name` string, required — The name of the variant. Must be <code>C</code> for control or <code>T1</code> for treatment.
    - `weight` integer, required — The percentage of traffic to route to this variant. Weights across all variants must sum to 100.
    - `variantConfiguration` object, required — The configuration for this variant, including the configuration bundle or target reference.
      - `configurationBundle` object — A reference to a configuration bundle version to use for this variant.
        - `bundleArn` string, required — The Amazon Resource Name (ARN) of the configuration bundle.
        - `bundleVersion` string, required — The version of the configuration bundle.
      - `target` object — A reference to a gateway target to route traffic to for this variant.
        - `name` string, required — The name of the gateway target.
  - `gatewayFilter` object — The gateway filter restricting which target paths are included.
    - `targetPaths` PathPattern[] — A list of target path patterns to include in the A/B test.
  - `evaluationConfig` object, required — The evaluation configuration for measuring variant performance.
    - `onlineEvaluationConfigArn` string — The Amazon Resource Name (ARN) of a single online evaluation configuration to use for both variants.
    - `perVariantOnlineEvaluationConfig` PerVariantOnlineEvaluationConfig[] — Per-variant online evaluation configurations, allowing different evaluation settings for each variant.
      - `name` string, required — The name of the variant this evaluation configuration applies to.
      - `onlineEvaluationConfigArn` string, required — The Amazon Resource Name (ARN) of the online evaluation configuration for this variant.
  - `roleArn` string — The IAM role ARN used by the A/B test.
  - `currentRunId` string — The identifier of the current run of the A/B test.
  - `errorDetails` ErrorDetailsListMemberString[] — The error details if the A/B test encountered failures.
  - `startedAt` string, date-time — The timestamp when the A/B test was started.
  - `stoppedAt` string, date-time — The timestamp when the A/B test was stopped.
  - `maxDurationExpiresAt` string, date-time — The timestamp when the A/B test will automatically expire.
  - `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.
  - `results` object — The statistical results of the A/B test, including per-evaluator metrics and significance analysis.
    - `analysisTimestamp` string, date-time — The timestamp when the analysis was performed.
    - `evaluatorMetrics` EvaluatorMetric[], required — The per-evaluator metrics comparing control and treatment variants.
      - `evaluatorArn` string, required — The Amazon Resource Name (ARN) of the evaluator.
      - `controlStats` object, required — The statistics for the control variant.
        - `variantName` string, required — The name of the control variant.
        - `sampleSize` integer, required — The number of sessions evaluated for the control variant.
        - `mean` number, double, required — The mean evaluation score for the control variant.
      - `variantResults` VariantResult[], required — The results for each treatment variant compared against the control.
        - `variantName` string, required — The name of the treatment variant.
        - `sampleSize` integer, required — The number of sessions evaluated for this variant.
        - `mean` number, double, required — The mean evaluation score for this variant.
        - `absoluteChange` number, double — The absolute change in mean score compared to the control variant.
        - `percentChange` number, double — The percentage change in mean score compared to the control variant.
        - `pValue` number, double — The p-value indicating the statistical significance of the observed difference.
        - `confidenceInterval` object — The confidence interval for the observed difference.
          - `lower` number, double — The lower bound of the confidence interval.
          - `upper` number, double — The upper bound of the confidence interval.
        - `isSignificant` boolean, required — Whether the observed difference is statistically significant.

## Other responses

- `480` — UnauthorizedException
- `481` — ValidationException
- `482` — AccessDeniedException
- `483` — ThrottlingException
- `484` — ResourceNotFoundException
- `485` — 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)