> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Experiments API

> Een Experiment is een feature flag of A/B-test die eigendom is van een account.

Treatments krijgen stabiele percentagebereiken van het verkeer en alle anderen krijgen control, zodat het vergroten van een allocatie nooit een bestaande gebruiker naar een andere arm verplaatst.

Gebruik de Experiments API om een concept aan te maken, de gewichten, targeting en resourcekoppelingen te configureren, het daarna te activeren, pauzeren of beëindigen, en om te evalueren welke arm een gebruiker, account of anonieme bezoeker krijgt. Voor het beheren van experimenten is `experiment:read` of `experiment:manage` vereist; evaluatie werkt zonder authenticatie.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Experimenten weergeven](https://docs.whop.com/nl/api-reference/experiments/list-experiments.md) | GET `/experiments` |
| [Experiment ophalen](https://docs.whop.com/nl/api-reference/experiments/retrieve-experiment.md) | GET `/experiments/{id}` |
| [Experimenten evalueren](https://docs.whop.com/nl/api-reference/experiments/evaluate-experiments.md) | GET `/experiments/exposures` |
| [Experiment aanmaken](https://docs.whop.com/nl/api-reference/experiments/create-experiment.md) | POST `/experiments` |
| [Experiment activeren](https://docs.whop.com/nl/api-reference/experiments/activate-experiment.md) | POST `/experiments/{id}/activate` |
| [Experiment beëindigen](https://docs.whop.com/nl/api-reference/experiments/end-experiment.md) | POST `/experiments/{id}/end` |
| [Experiment pauzeren](https://docs.whop.com/nl/api-reference/experiments/pause-experiment.md) | POST `/experiments/{id}/pause` |
| [Experiment bijwerken](https://docs.whop.com/nl/api-reference/experiments/update-experiment.md) | PATCH `/experiments/{id}` |

## Attributen

**id** `string` *required*

Unieke identificatie van het experiment, met prefix `expt_`.

**account\_id** `string` *required*

ID van het eigenaarsaccount.

**assignment\_seed** `string` *required*

Toewijzing hasht de UTF-8-seed + subject-ID met CRC32 modulo 100 en selecteert
het opgeslagen bereik (eindwaarde exclusief).

**bucket\_by** `string | null`

Randomisatie-eenheid — `user` verdeelt elke gebruiker afzonderlijk in buckets, `account` verdeelt hele accounts in buckets (elke gebruiker van een account krijgt dezelfde arm). `null` voor feature flags.

Beschikbare opties: `user`, `account`, `anonymous`

**configuration\_revision** `integer` *required*

Revisie van de actieve configuratie. Wordt bij elke configuratiewijziging
verhoogd, dus een gecachte definitie met een lagere revisie is verouderd.
Wijzigt de assignment seed niet.

**control** `object` *required*

> [accordion] Eigenschappen
>
> **related\_resource** `object | null`
>
> > [accordion] Eigenschappen
> >
> > **id** `string` *required*
> >
> > Tag van de gerefereerde resource, die toebehoort aan de eigenaar van het
> > experiment.
> >
> > **object** `string` *required*
> >
> > Beschikbare opties: `app`, `app_build`, `product`, `plan`

**created\_at** `string | null`

Wanneer het experiment is aangemaakt, als ISO 8601-tijdstempel.

**created\_by** `string | null`

ID van de gebruiker die het experiment heeft aangemaakt, met prefix `user_`.
`null` voor experimenten die zijn aangemaakt voordat makers werden vastgelegd.

**ended\_at** `string | null`

Wanneer het experiment is gestopt met het verzamelen van gegevens, als ISO
8601-tijdstempel. `null` zolang het nog loopt.

**findings** `string | null`

Wat er is geleerd en waarom deze uitkomst, vastgelegd toen het experiment werd
beëindigd. Tot dan `null`.

**flag\_key** `string` *required*

Door de ontwikkelaar gekozen handle waarnaar vanuit code wordt verwezen. Overal
waar de API een experiment-identificatie accepteert, zijn het `expt_`-id en de
flag\_key uitwisselbaar.

**hypothesis** `string | null`

Hypothese voor dit experiment. `null` wanneer er geen is ingesteld, en altijd
`null` voor feature flags.

**metadata** `object`

Key-value-paren die bij het aanmaken van het experiment zijn toegevoegd. Leeg
wanneer er geen zijn ingesteld.

**name** `string` *required*

Leesbare weergavenaam.

**related\_resource** `object | null` *required*

Resource van het account waaraan dit experiment is gekoppeld, zoals een app of product. `null` wanneer niet gekoppeld. Ligt vast zodra het experiment voor het eerst wordt geactiveerd.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Tag van de gerefereerde resource, die toebehoort aan de eigenaar van het
> experiment.
>
> **object** `string` *required*
>
> Beschikbare opties: `app`, `app_build`, `product`, `plan`

**started\_at** `string | null`

Wanneer het experiment is begonnen met het verzamelen van gegevens, als ISO
8601-tijdstempel. `null` voor concepten.

**status** `string` *required*

Levenscyclusstatus. `draft` — nog niet live; `active` — loopt momenteel; `paused` — verkeer gepauzeerd; `ended` — afgerond.

Beschikbare opties: `draft`, `active`, `paused`, `ended`

**updated\_at** `string | null` *required*

**variants** `object[]` *required*

Treatment-armen. Gebruikers buiten de allocatie van elke arm vormen de impliciete `control`-groep. Gewichten worden alleen ooit groter en armen worden nooit verwijderd, dus een gebruiker verhuist hooguit één keer van control naar een treatment.

> [accordion] Eigenschappen
>
> **name** `string` *required*
>
> Treatment-identificatie. `control` is gereserveerd — dat is de impliciete rest.
>
> **ranges** `integer[][]`
>
> Toegekende bucketbereiken (eenheden van 1%, eindwaarde exclusief) die de
> allocatiegeschiedenis van deze arm vastleggen. Beheerd door de server; bereiken
> worden alleen toegevoegd, wat toewijzingen permanent houdt.
>
> **related\_resource** `object | null`
>
> > [accordion] Eigenschappen
> >
> > **id** `string` *required*
> >
> > Tag van de gerefereerde resource, die toebehoort aan de eigenaar van het
> > experiment.
> >
> > **object** `string` *required*
> >
> > Beschikbare opties: `app`, `app_build`, `product`, `plan`
>
> **weight** `integer` *required*
>
> Percentage van alle gebruikers dat aan deze treatment wordt toegewezen, 1–100. Alle gewichten samen tellen op tot maximaal 100; de rest is control.

**winning\_arm** `string | null`

De treatment die heeft gewonnen, ingesteld toen het experiment werd beëindigd.
Eenmaal ingesteld retourneert elke evaluatie deze arm aan elke aanroeper,
ongeacht targeting of allocatie, en worden er geen verdere exposures
vastgelegd. `null` betekent dat control heeft gewonnen — een beëindigd
experiment zonder winnende arm evalueert voor iedereen naar `control`. Altijd
`null` voor feature flags, die na beëindiging simpelweg als uitgeschakeld
evalueren.

```json Experiment theme={null}
{
	"id": "expt_xxxxxxxxxxxxxx",
	"account_id": "biz_xxxxxxxxxxxxxx",
	"flag_key": "checkout_redesign_v2",
	"name": "Checkout Redesign V2",
	"hypothesis": "A single-step checkout raises conversion.",
	"status": "active",
	"bucket_by": "user",
	"assignment_seed": "checkout_redesign_v21789462000",
	"configuration_revision": 2,
	"variants": [
		{
			"name": "treatment",
			"weight": 50,
			"ranges": [[0, 50]],
			"related_resource": null
		}
	],
	"control": {
		"related_resource": null
	},
	"related_resource": null,
	"winning_arm": null,
	"findings": null,
	"created_by": "user_xxxxxxxxxxxxxx",
	"created_at": "2026-09-01T12:00:00.000Z",
	"started_at": "2026-09-02T09:00:00.000Z",
	"ended_at": null,
	"updated_at": "2026-09-02T09:00:00.000Z"
}
```


## Related topics

- [Evaluate Experiments](https://docs.whop.com/nl/api-reference/experiments/evaluate-experiments.md)
- [Activate Experiment](https://docs.whop.com/nl/api-reference/experiments/activate-experiment.md)
- [Pause Experiment](https://docs.whop.com/nl/api-reference/experiments/pause-experiment.md)
