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

# List A/B experiments

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

## Request

- Base URL: `https://api.together.ai`
- URL: `https://api.together.ai/v2/projects/{projectId}/endpoints/{endpointId}/abExperiments`
- Auth: HTTP bearer

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

## Changes

- **2026-10-22** `bb5257b3173a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/together/apis/together-apis/changes/v2/projects/:projectId/endpoints/:endpointId/abExperiments/get.md)

---

[API](https://skmtc.dev/together/apis/together-apis.md) - [All operations](https://skmtc.dev/together/apis/together-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/together/apis/together-apis/revisions/93438ddac711?raw)