Sign in
Experiments

List Experiments

Lists experiments for one account with experiment:read permission. Omit account_id or pass internal to list internal experiments, which requires Whop internal access.

get/experiments

Query parameters

account_idstring

Owning account ID. Omit or pass internal for Whop internal experiments; internal access is required.

idstring required

Referenced resource tag, belonging to the experiment owner.

object'app' | 'app_build' | 'product' | 'plan' required

Filter by related resource; requires account_id.

{
  "object": "app"
}
status'draft' | 'active' | 'paused' | 'ended'

Only experiments with this status.

firstinteger

Number of results to return from the start of the range.

afterstring

Return results after this cursor. Use page_info.end_cursor from the previous response to fetch the next page.

lastinteger

Number of results to return from the end of the range.

beforestring

Return results before this cursor. Use page_info.start_cursor from the previous response to fetch the previous page.

order'created_at' | 'flag_key'

The field to sort experiments by.

direction'asc' | 'desc'

Sort direction.

Response

experiments listed

Example response

{
  "data": [
    {
      "account_id": "internal",
      "assignment_seed": "checkout_redesign_v21768435200",
      "bucket_by": "user",
      "configuration_revision": 1,
      "control": {
        "related_resource": {
          "object": "app"
        }
      },
      "created_at": "2026-01-01T12:00:00.000Z",
      "created_by": "user_xxxxxxxxxxxxxx",
      "ended_at": "2026-01-01T12:00:00.000Z",
      "findings": "Treatment lifted conversion 8%",
      "flag_key": "checkout_redesign_v2",
      "hypothesis": "Users will convert more",
      "id": "expt_xxxxxxxxxxxxxx",
      "name": "Checkout Redesign V2",
      "related_resource": {
        "object": "app"
      },
      "started_at": "2026-01-01T12:00:00.000Z",
      "status": "draft",
      "targeting_rules": [
        {
          "conditions": [
            {
              "operator": "any",
              "type": "user_id"
            }
          ],
          "type": "include"
        }
      ],
      "updated_at": "2026-01-01T12:00:00.000Z",
      "variants": [
        {
          "name": "treatment",
          "ranges": [
            [
              0,
              50
            ]
          ],
          "related_resource": {
            "object": "app"
          },
          "weight": 50
        }
      ],
      "winning_arm": "treatment"
    }
  ],
  "page_info": {
    "start_cursor": "WyJjdXJzb3IiLDFd"
  }
}

Changes

Changed in 1 of the 74 revisions of this API.12

  • ff3a7657356312See the full diff
    • ▲

      for the query request parameter first, default value 20 was added

      request-parameter-default-value-added

    • ●

      for the query request parameter first, the max was set to 100.00

      request-parameter-max-set

    • ●

      for the query request parameter last, the max was set to 100.00

      request-parameter-max-set

Of the 74 revisions, 1 has no diff computed.