---
title: "Start Price Experiment"
method: POST
path: "/api/v1/playbooks/{playbook_id}/price-experiments/{exp_id}/start"
tags: ["playbook-pricing"]
---

# Start Price Experiment

`POST /api/v1/playbooks/{playbook_id}/price-experiments/{exp_id}/start`

## Request

- Base URL: `https://api.badgeia.com`
- URL: `https://api.badgeia.com/api/v1/playbooks/{playbook_id}/price-experiments/{exp_id}/start`
- Auth: none declared

Transition a draft experiment → running.

Re-checks the "no other running exp" rule (something might have started
between create and start). Sets `started_at` and `ends_at` (started_at +
PRICING_EXPERIMENTS_AUTO_CONCLUDE_DAYS).

## Path parameters

- `playbook_id` string, uuid, required
- `exp_id` string, uuid, required

## Response `200`

Successful Response

- PriceExperimentRead: Full experiment row + computed-on-read fields.
  - `id` string, uuid, required
  - `playbook_id` string, uuid, required
  - `creator_user_id` string, uuid, nullable, required
  - `variants_json` object[], required
  - `status` string, required
  - `started_at` string, date-time, nullable, required
  - `ends_at` string, date-time, nullable, required
  - `min_sample_per_variant` integer, required
  - `winner_variant_label` string, nullable, required
  - `notes` string, nullable, required
  - `created_at` string, date-time, required
  - `concluded_at` string, date-time, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/badgeia/apis/badge.md) · [All operations](https://skmtc.dev/badgeia/apis/badge/llms.txt) · [OpenAPI document](https://skmtc.dev/badgeia/apis/badge/revisions/7e7f7fee8b77?raw)