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

# API de Experiments

> Un Experiment es un feature flag o una prueba A/B propiedad de una cuenta.

Los tratamientos toman rangos porcentuales estables del tráfico y todos los demás reciben el control, por lo que aumentar una asignación nunca mueve a un usuario existente a otro grupo.

Usa la API de Experiments para crear un borrador, configurar sus pesos, segmentación y vinculaciones de recursos, y luego activarlo, pausarlo o finalizarlo, así como para evaluar qué grupo recibe un usuario, una cuenta o un visitante anónimo. Gestionar experimentos requiere `experiment:read` o `experiment:manage`; la evaluación funciona sin autenticación.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar Experiments](https://docs.whop.com/es/api-reference/experiments/list-experiments.md) | GET `/experiments` |
| [Recuperar Experiment](https://docs.whop.com/es/api-reference/experiments/retrieve-experiment.md) | GET `/experiments/{id}` |
| [Evaluar Experiments](https://docs.whop.com/es/api-reference/experiments/evaluate-experiments.md) | GET `/experiments/exposures` |
| [Crear Experiment](https://docs.whop.com/es/api-reference/experiments/create-experiment.md) | POST `/experiments` |
| [Activar Experiment](https://docs.whop.com/es/api-reference/experiments/activate-experiment.md) | POST `/experiments/{id}/activate` |
| [Finalizar Experiment](https://docs.whop.com/es/api-reference/experiments/end-experiment.md) | POST `/experiments/{id}/end` |
| [Pausar Experiment](https://docs.whop.com/es/api-reference/experiments/pause-experiment.md) | POST `/experiments/{id}/pause` |
| [Actualizar Experiment](https://docs.whop.com/es/api-reference/experiments/update-experiment.md) | PATCH `/experiments/{id}` |

## Atributos

**id** `string` *required*

Identificador único del experimento, con el prefijo `expt_`.

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

ID de la cuenta propietaria.

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

La asignación aplica un hash a la semilla UTF-8 + el ID del sujeto con CRC32 módulo 100 y selecciona el rango almacenado con extremo final exclusivo.

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

Unidad de aleatorización: `user` asigna cada usuario de forma independiente, `account` asigna cuentas completas (todos los usuarios de una cuenta reciben el mismo grupo). `null` para feature flags.

Opciones disponibles: `user`, `account`, `anonymous`

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

Revisión de la configuración de servicio. Se incrementa con cada cambio de configuración, por lo que una definición en caché con una revisión inferior está obsoleta. No cambia la semilla de asignación.

**control** `object` *required*

> [accordion] Propiedades
>
> **related\_resource** `object | null`
>
> > [accordion] Propiedades
> >
> > **id** `string` *required*
> >
> > Etiqueta del recurso referenciado, que pertenece al propietario del experimento.
> >
> > **object** `string` *required*
> >
> > Opciones disponibles: `app`, `app_build`, `product`, `plan`

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

Cuándo se creó el experimento, como marca de tiempo ISO 8601.

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

ID del usuario que creó el experimento, con el prefijo `user_`. `null` para experimentos creados antes de que se registraran los creadores.

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

Cuándo dejó el experimento de recopilar datos, como marca de tiempo ISO 8601. `null` mientras sigue en ejecución.

**findings** `string | null`

Qué se aprendió y por qué este resultado, registrado cuando se finalizó el experimento. `null` hasta entonces.

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

Identificador elegido por el desarrollador y referenciado desde el código. En cualquier lugar donde la API acepta un identificador de experimento, el ID `expt_` y el flag\_key son intercambiables.

**hypothesis** `string | null`

Hipótesis de este experimento. `null` cuando no se ha establecido ninguna, y siempre `null` para feature flags.

**metadata** `object`

Pares clave-valor adjuntados cuando se creó el experimento. Vacío cuando no se estableció ninguno.

**name** `string` *required*

Nombre para mostrar legible.

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

Recurso propiedad de la cuenta al que está vinculado este experimento, como una app o un producto. `null` cuando no está vinculado. Queda fijado una vez que el experimento se activa por primera vez.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> Etiqueta del recurso referenciado, que pertenece al propietario del experimento.
>
> **object** `string` *required*
>
> Opciones disponibles: `app`, `app_build`, `product`, `plan`

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

Cuándo comenzó el experimento a recopilar datos, como marca de tiempo ISO 8601. `null` para borradores.

**status** `string` *required*

Estado del ciclo de vida. `draft`: aún no está activo; `active`: en ejecución; `paused`: tráfico en pausa; `ended`: concluido.

Opciones disponibles: `draft`, `active`, `paused`, `ended`

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

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

Grupos de tratamiento. Los usuarios fuera de la asignación de todos los grupos forman el grupo `control` implícito. Los pesos solo crecen y los grupos nunca se eliminan, por lo que un usuario pasa del control a un tratamiento como máximo una vez.

> [accordion] Propiedades
>
> **name** `string` *required*
>
> Identificador del tratamiento. `control` está reservado: es el resto implícito.
>
> **ranges** `integer[][]`
>
> Rangos de buckets concedidos (unidades del 1 %, con extremo final exclusivo) que registran el historial de asignación de este grupo. Gestionados por el servidor; los rangos solo se añaden, lo que mantiene las asignaciones permanentes.
>
> **related\_resource** `object | null`
>
> > [accordion] Propiedades
> >
> > **id** `string` *required*
> >
> > Etiqueta del recurso referenciado, que pertenece al propietario del experimento.
> >
> > **object** `string` *required*
> >
> > Opciones disponibles: `app`, `app_build`, `product`, `plan`
>
> **weight** `integer` *required*
>
> Porcentaje de todos los usuarios asignados a este tratamiento, de 1 a 100. Todos los pesos juntos suman como máximo 100; el resto es el control.

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

El tratamiento ganador, establecido cuando se finalizó el experimento. Una vez establecido, toda evaluación devuelve este grupo a cualquier llamador, independientemente de la segmentación o la asignación, y no se registran más exposiciones. `null` significa que ganó el control: un experimento finalizado sin grupo ganador se evalúa como `control` para todos. Siempre `null` para feature flags, que simplemente se evalúan como deshabilitados una vez finalizados.

```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

- [Versiones de la API](https://docs.whop.com/es/developer/api/versioning.md)
- [Estabilidad de la API](https://docs.whop.com/es/api-reference/stability.md)
- [Descripción general de la API de Whop](https://docs.whop.com/es/api-reference/overview.md)
