---
title: "Get an A/B experiment"
method: GET
path: "/projects/{projectId}/endpoints/{endpointId}/abExperiments/{id}"
tags: ["ABExperimentService"]
---

# Get an A/B experiment

`GET /projects/{projectId}/endpoints/{endpointId}/abExperiments/{id}`

Retrieves an A/B experiment and its participating deployments, roles, and traffic percentages.

## Path parameters

- `projectId` string, required — Project identifier.
- `endpointId` string, required — Endpoint identifier.
- `id` string, required — A/B experiment identifier.

## Response `200`

OK

- DEABExperiment — Managed cohort split that subdivides a control deployment's live traffic among the control and one or more variants.
  - `id` string, required — Output only. Unique A/B experiment identifier.
  - `projectId` string, required — Output only. Project that owns the parent endpoint.
  - `endpointId` string, required — Output only. Endpoint this A/B experiment belongs to.
  - `name` string, required — Human-readable A/B experiment name, unique within the endpoint.
  - `description` string — Optional free-form description.
  - `members` DEABExperimentMember[], required — Two to 20 participating deployments with exactly one control and percentages that add up to 100.
    - `deploymentId` string, required — Deployment under the parent endpoint.
    - `role` 'AB_EXPERIMENT_MEMBER_ROLE_CONTROL' | 'AB_EXPERIMENT_MEMBER_ROLE_VARIANT', required — Role of this deployment within the A/B experiment.
    - `percent` integer, required — Integer traffic percent in [1, 100]. Percentages across all members must sum to 100.
  - `createdBy` string, required — Output only. Identifier of the principal that created the A/B experiment.
  - `createdAt` string, date-time, required — Output only. Timestamp when the A/B experiment was created.
  - `updatedAt` string, date-time, required — Output only. Timestamp when the A/B experiment was last updated.
  - `etag` string, required — Optional opaque version tag for optimistic concurrency control.

## Other responses

- `default` — Default error response

---

[API](https://skmtc.net/together/apis/together-apis.md) · [All operations](https://skmtc.net/together/apis/together-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/together/together-apis/revisions/468edbdc879c/schema)