---
title: "List A/B experiments"
method: GET
path: "/projects/{projectId}/endpoints/{endpointId}/abExperiments"
tags: ["ABExperimentService"]
---

# List A/B experiments

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

Lists the managed live-traffic experiments configured for an endpoint.

## Path parameters

- `projectId` string, required — Project identifier.
- `endpointId` string, required — Endpoint identifier.

## Query parameters

- `limit` integer — Maximum number of A/B experiments to return. Max 500, defaults to 50.
- `after` string — Cursor from a previous A/B experiment list response.

## Response `200`

OK

- DEListABExperimentsResponse — Managed A/B traffic experiments under an endpoint.
  - `data` DEABExperiment[], required — A/B experiments under the endpoint.
    - `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.
  - `next_cursor` string — Cursor for the next page. Null if there are no more results.
  - `object` 'list', required — Object type. Always `list`.

## 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)