---
title: "How much of this workstream a new experiment can still have"
method: GET
path: "/api/v1/campaigns/{campaign_id}/experiments/capacity"
tags: ["experiments"]
---

# How much of this workstream a new experiment can still have

`GET /api/v1/campaigns/{campaign_id}/experiments/capacity`

## Request

- Base URL: `https://api.outrival.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.outrival.com/api/v1/campaigns/{campaign_id}/experiments/capacity`
- Auth: HTTP bearer

Remaining share of the proposed eligible set, and who holds overlapping sets.

``allocated`` and ``remaining`` are proportions in 0..1 of the eligible
cohort (named targeting minus same-section blockers), not the whole
workstream. ``holders`` names each running experiment. ``max_treatment_share``
is the launch ceiling for this eligible set.
``has_running_v1`` is true when any V1 experience is still running.
``running_v1`` is that experience's ``id`` and ``name``, or null.

## Path parameters

- `campaign_id` string, required

## Query parameters

- `targeting_rules` string, nullable: JSON targeting list for the proposed try. Omitted: campaign-level remaining (1.0 if every running try has named targeting). Pass [] for everyone minus same-section blockers.
- `pin_overrides` string, nullable: JSON {section: version} pins for the proposed try.

## Response `200`

Successful Response

- object

## Other responses

- `400`: Invalid campaign ID format
- `403`: User may not edit this campaign
- `404`: Campaign not found
- `422`: Validation Error

## Changes

- **2026-09-03** `219a10b80707`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/outrival/apis/fastapi/changes/api/v1/campaigns/:campaign_id/experiments/capacity/get.md)

---

[API](https://skmtc.dev/outrival/apis/fastapi.md) - [All operations](https://skmtc.dev/outrival/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/outrival/apis/fastapi/revisions/f27d90300b5e?raw)