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

# Conclude Price Experiment

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

## Request

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

Conclude a running experiment + promote winner to canonical price (FR-07).

Winner-selection priority:
  1. `payload.winner_variant_label` (creator override).
  2. Highest-conversion variant (computed from assignments).
  3. Control (if there's no signal at all).

All three branches write a `playbook_price_history` row with reason
`experiment_concluded` + the experiment id (for forensics dashboards).

## Path parameters

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

## Request body

- PriceExperimentConcludeRequest: Manual-conclude payload. `winner_variant_label` is optional — when null, the service auto-picks the highest-converting variant (FR-07).
  - `winner_variant_label` string, nullable

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