---
title: "List experiments on a data source"
---

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

# List experiments on a data source

Path: Evidential Experiments API › Experiments

`GET /v1/experiments`

URL: `https://api.evidential.dev/v1/experiments`

## Authentication

- `DatasourceApiKey`, apiKey, in header, header `X-API-Key`

## Header parameters

- `Datasource-ID` (`list_experiments.header.Datasource-ID`; string, required) — The ID of the datasource to operate on.
  - example: `"testing"`

## Code samples

### cURL

```bash
curl --request GET \
  --url https://api.evidential.dev/v1/experiments \
  --header 'Datasource-ID: testing' \
  --header 'X-API-Key: <X-API-Key>'
```

### TypeScript

```typescript
const url = 'https://api.evidential.dev/v1/experiments';
const options = {
  method: 'GET',
  headers: {'Datasource-ID': 'testing', 'X-API-Key': '<X-API-Key>'}
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://api.evidential.dev/v1/experiments"

headers = {
    "Datasource-ID": "testing",
    "X-API-Key": "<X-API-Key>"
}

response = requests.get(url, headers=headers)

print(response.text)
```

## Responses

### 200

Successful Response

#### Example

```json
{
  "items": [
    {
      "experiment_id": "string",
      "datasource_id": "string",
      "spreadsheet_full_url": "string",
      "state": "assigned",
      "stopped_assignments_at": "2019-08-24T14:15:22Z",
      "stopped_assignments_reason": "preassigned",
      "design_spec": {
        "experiment_type": "freq_preassigned",
        "experiment_name": "string",
        "description": "string",
        "design_url": "http://example.com",
        "start_date": "2019-08-24T14:15:22Z",
        "end_date": "2019-08-24T14:15:22Z",
        "arms": [
          {
            "arm_id": "string",
            "arm_name": "string",
            "arm_description": "string",
            "arm_weight": 99
          },
          {
            "arm_id": "string",
            "arm_name": "string",
            "arm_description": "string",
            "arm_weight": 99
          }
        ],
        "table_name": "string",
        "primary_key": "field_name",
        "strata": [
          {
            "field_name": "field_name"
          }
        ],
        "metrics": [
          {
            "field_name": "field_name",
            "metric_pct_change": 0,
            "metric_target": 0,
            "icc": 0,
            "avg_cluster_size": 0,
            "cv": 0,
            "metric_type": "binary",
            "metric_baseline": 0,
            "metric_stddev": 0,
            "available_nonnull_n": 0,
            "available_n": 0,
            "use_one_time_metric": false
          }
        ],
        "filters": [
          {
            "field_name": "field_name",
            "relation": "includes",
            "value": [
              0
            ]
          }
        ],
        "desired_n": 0,
        "desired_ns": [
          1
        ],
        "power": 0.8,
        "alpha": 0.05,
        "fstat_thresh": 0.6,
        "cluster_key": "string",
        "desired_n_clusters": 1,
        "desired_ns_clusters": [
          1
        ]
      },
      "power_analyses": {
        "analyses": [
          {
            "metric_spec": {
              "field_name": "field_name",
              "metric_pct_change": 0,
              "metric_target": 0,
              "icc": 0,
              "avg_cluster_size": 0,
              "cv": 0,
              "metric_type": "binary",
              "metric_baseline": 0,
              "metric_stddev": 0,
              "available_nonnull_n": 0,
              "available_n": 0,
              "use_one_time_metric": false,
              "is_one_time_eligible": false
            },
            "target_n": 0,
            "sufficient_n": true,
            "target_possible": 0,
            "pct_change_possible": 0,
            "target_possible_lower": 0,
            "pct_change_possible_lower": 0,
            "pct_change_with_desired_n": 0,
            "mde_curve": [
              {}
            ],
            "msg": {
              "type": "sufficient",
              "msg": "string",
              "source_msg": "string",
              "values": {},
              "high_cluster_variation": false
            },
            "num_clusters_total": 0,
            "clusters_per_arm": [
              0
            ],
            "n_per_arm": [
              0
            ],
            "design_effect": 0,
            "effective_sample_size": 0
          }
        ]
      },
      "assign_summary": {
        "balance_check": {
          "f_statistic": 0,
          "numerator_df": 0,
          "denominator_df": 0,
          "p_value": 0,
          "balance_ok": true
        },
        "sample_size": 0,
        "arm_sizes": [
          {
            "arm": {
              "arm_id": "string",
              "arm_name": "string",
              "arm_description": "string",
              "arm_weight": 99
            },
            "size": 0,
            "cluster_count": 0
          }
        ]
      },
      "webhooks": [],
      "decision": "",
      "impact": "high"
    }
  ]
}
```

- `items` (`list_experiments.response.200.items`; array of object, required)
  - `experiment_id` (`list_experiments.response.200.items.experiment_id`; string, required) — Server-generated ID of the experiment.
  - `datasource_id` (`list_experiments.response.200.items.datasource_id`; string, required)
  - `state` (`list_experiments.response.200.items.state`; string, required) — Current state of this experiment.
    - one of `"assigned"`, `"abandoned"`, `"committed"`
  - `stopped_assignments_at` (`list_experiments.response.200.items.stopped_assignments_at`; any of, required) — The date and time when assignments were stopped. Null if the experiment is still accepting assignments. This date can change if the experiment's end date is modified.
    - any of the following: `string`, `null`
  - `stopped_assignments_reason` (`list_experiments.response.200.items.stopped_assignments_reason`; any of, required)
    - any of the following: `StopAssignmentReason`, `null`
  - `design_spec` (`list_experiments.response.200.items.design_spec`; DesignSpec, required) — The type of assignment and experiment design.
    - one of the following:
      - `AnyBanditDesignSpec` (`cmab_online`)
        - every option has:
          - `experiment_name` (`<option>.experiment_name`; string, required)
            - maxLength: `100`
          - `description` (`<option>.description`; string, required)
            - maxLength: `2000`
          - `start_date` (`<option>.start_date`; string, required)
            - format: `date-time`
          - `end_date` (`<option>.end_date`; string, required)
            - format: `date-time`
          - `arms` (`<option>.arms`; array of object, required)
            - `arm_name` (`<option>.arms.arm_name`; string, required)
              - maxLength: `100`
            - `arm_id` (`<option>.arms.arm_id`; any of, optional) — Unique ID of the arm. Leave unset when creating an arm.
              - any of the following: `string`, `null`
            - `arm_description` (`<option>.arms.arm_description`; any of, optional)
              - any of the following: `string`, `null`
            - `arm_weight` (`<option>.arms.arm_weight`; any of, optional) — Optional weight for this arm, used for unequal allocation. The weight must be greater than 0 and less than 100. If you set a weight, all arms must have weights, and they must sum to 100.
              - any of the following: `ArmWeight`, `null`
            - `alpha_init` (`<option>.arms.alpha_init`; any of, optional) — Initial alpha parameter for the Beta prior.
              - any of the following: `number`, `null`
            - `beta_init` (`<option>.arms.beta_init`; any of, optional) — Initial beta parameter for the Beta prior.
              - any of the following: `number`, `null`
            - `mu_init` (`<option>.arms.mu_init`; any of, optional) — Initial mean parameter for the Normal prior.
              - any of the following: `number`, `null`
            - `sigma_init` (`<option>.arms.sigma_init`; any of, optional) — Initial standard deviation parameter for the Normal prior.
              - any of the following: `number`, `null`
            - `alpha` (`<option>.arms.alpha`; any of, optional) — Updated alpha parameter for the Beta prior.
              - any of the following: `number`, `null`
            - `beta` (`<option>.arms.beta`; any of, optional) — Updated beta parameter for the Beta prior.
              - any of the following: `number`, `null`
            - `mu` (`<option>.arms.mu`; any of, optional) — Updated mean vector for the Normal prior.
              - any of the following: `array<number>`, `null`
            - `covariance` (`<option>.arms.covariance`; any of, optional) — Updated covariance matrix for the Normal prior.
              - any of the following: `array<array<number>>`, `null`
          - `design_url` (`<option>.design_url`; any of, optional) — Optional URL to a more detailed experiment design doc.
            - any of the following: `string`, `null`
          - `contexts` (`<option>.contexts`; any of, optional) — Optional list of contexts that can be used to condition the assignment. Required for Contextual Multi-armed Bandit (CMAB) experiments.
            - any of the following:
              - `array<unknown>`
                - `context_name` (`<option>.contexts.1.context_name`; string, required)
                  - maxLength: `100`
                - `context_id` (`<option>.contexts.1.context_id`; any of, optional) — Unique identifier for the context. Do not set this when you create a new context.
                  - any of the following: `string`, `null`
                - `context_description` (`<option>.contexts.1.context_description`; any of, optional)
                  - any of the following: `string`, `null`
                - `value_type` (`<option>.contexts.1.value_type`; string, optional) — Type of value the context can take.
                  - one of `"binary"`, `"real-valued"` · default: `"binary"`
              - `null`
          - `prior_type` (`<option>.prior_type`; string, optional) — The type of prior distribution for the arms.
            - one of `"beta"`, `"normal"` · default: `"beta"`
          - `reward_type` (`<option>.reward_type`; string, optional) — The type of outcome observed from the experiment.
            - one of `"binary"`, `"real-valued"` · default: `"binary"`
          - `enable_autofail` (`<option>.enable_autofail`; boolean, optional) — When true, Evidential records a failure for participants whose outcome does not arrive (via either push or pull) within a specified time window.
            - default: `false`
          - `autofail_window` (`<option>.autofail_window`; integer, optional) — The time window in hours after which a participant is considered to have failed if no outcome arrives (via either push or pull). Default is 24 hours. Required if enable_autofail is true.
            - minimum: `1` · default: `24`
          - `autofail_outcome_value` (`<option>.autofail_outcome_value`; number, optional) — The outcome value to assign to participants who are automatically failed. Required if enable_autofail is true.
            - default: `0`
        - one of the following, each adding:
          - `CMABExperimentSpec` (`cmab_online`)
            - `experiment_type` (`CMABExperimentSpec.experiment_type`; string, optional)
              - default: `"cmab_online"`
          - `MABExperimentSpec` (`mab_online`)
            - `experiment_type` (`MABExperimentSpec.experiment_type`; string, optional)
              - default: `"mab_online"`
          - `MABDwhExperimentSpec` (`mab_online_dwh`)
            - `table_name` (`MABDwhExperimentSpec.table_name`; string, required) — Datasource table used to resolve target field metadata.
              - maxLength: `100`
            - `primary_key` (`MABDwhExperimentSpec.primary_key`; string, required) — Column name in table_name that uniquely identifies each participant.
              - maxLength: `300` · minLength: `1`
            - `target_field_name` (`MABDwhExperimentSpec.target_field_name`; string, required) — Column name in table_name whose values this bandit optimises. Its data type is resolved from the DWH at create-time and used to validate subsequent outcome reports.
              - maxLength: `300` · minLength: `1`
            - `experiment_type` (`MABDwhExperimentSpec.experiment_type`; string, optional)
              - default: `"mab_online_dwh"`
      - `AnyFrequentistDesignSpec` (`freq_online`)
        - every option has:
          - `experiment_name` (`<option>.experiment_name`; string, required)
            - maxLength: `100`
          - `description` (`<option>.description`; string, required)
            - maxLength: `2000`
          - `start_date` (`<option>.start_date`; string, required)
            - format: `date-time`
          - `end_date` (`<option>.end_date`; string, required)
            - format: `date-time`
          - `arms` (`<option>.arms`; array of object, required)
            - `arm_name` (`<option>.arms.arm_name`; string, required)
              - maxLength: `100`
            - `arm_id` (`<option>.arms.arm_id`; any of, optional) — Unique ID of the arm. Leave unset when creating an arm.
              - any of the following: `string`, `null`
            - `arm_description` (`<option>.arms.arm_description`; any of, optional)
              - any of the following: `string`, `null`
            - `arm_weight` (`<option>.arms.arm_weight`; any of, optional) — Optional weight for this arm, used for unequal allocation. The weight must be greater than 0 and less than 100. If you set a weight, all arms must have weights, and they must sum to 100.
              - any of the following: `ArmWeight`, `null`
          - `table_name` (`<option>.table_name`; string, required) — Data source table used to resolve participant field metadata.
            - maxLength: `100`
          - `primary_key` (`<option>.primary_key`; string, required) — Column name in table_name that uniquely identifies each participant.
            - maxLength: `300` · minLength: `1`
          - `strata` (`<option>.strata`; array of object, required) — Optional fields to use for stratified assignment.
            - `field_name` (`<option>.strata.field_name`; string, required)
              - maxLength: `300` · minLength: `1`
          - `metrics` (`<option>.metrics`; array of object, required) — Primary and optional secondary metrics to target.
            - `field_name` (`<option>.metrics.field_name`; string, required)
              - maxLength: `300` · minLength: `1`
            - `metric_pct_change` (`<option>.metrics.metric_pct_change`; any of, optional) — The smallest percent change, relative to metric_baseline, that you want to be able to detect. Cannot be set together with metric_target.
              - any of the following: `number`, `null`
            - `metric_target` (`<option>.metrics.metric_target`; any of, optional) — The absolute value you want to be able to detect. Cannot be set together with metric_pct_change.
              - any of the following: `number`, `null`
            - `icc` (`<option>.metrics.icc`; any of, optional) — Intracluster correlation coefficient for cluster-randomized designs.
              - any of the following: `number`, `null`
            - `avg_cluster_size` (`<option>.metrics.avg_cluster_size`; any of, optional) — Average number of participants per cluster.
              - any of the following: `number`, `null`
            - `cv` (`<option>.metrics.cv`; any of, optional) — Coefficient of variation in cluster sizes (0 = equal sizes).
              - any of the following: `number`, `null`
            - `metric_type` (`<option>.metrics.metric_type`; any of, optional) — Inferred from the data warehouse column type.
              - any of the following: `MetricType`, `null`
            - `metric_baseline` (`<option>.metrics.metric_baseline`; any of, optional) — Mean of the tracked metric.
              - any of the following: `number`, `null`
            - `metric_stddev` (`<option>.metrics.metric_stddev`; any of, optional) — Standard deviation is set only for MetricType.NUMERIC metrics. Must be set for numeric metrics when available_n > 0.
              - any of the following: `number`, `null`
            - `available_nonnull_n` (`<option>.metrics.available_nonnull_n`; any of, optional) — The number of participants who meet the filtering criteria and have a non-null value for this metric.
              - any of the following: `integer`, `null`
            - `available_n` (`<option>.metrics.available_n`; any of, optional) — The number of participants who meet the filtering criteria, whether or not this metric's value is NULL. Note: assignments are made from the available_n population. When available_n is greater than available_nonnull_n, some assigned participants may have a missing value for this metric.
              - any of the following: `integer`, `null`
            - `use_one_time_metric` (`<option>.metrics.use_one_time_metric`; boolean, optional) — Enable one-time metric mode: only assign participants with null values for this metric. Only allowed on the primary (first) metric of an individually-randomized preassigned experiment.
              - default: `false`
          - `filters` (`<option>.filters`; array of object, required) — Optional filters that narrow the eligible audience to the participants you want in the experiment.
            - `field_name` (`<option>.filters.field_name`; string, required)
              - maxLength: `300` · minLength: `1`
            - `relation` (`<option>.filters.relation`; string, required) — Defines operators for filtering values. INCLUDES matches when the value matches any of the provided values, including null if explicitly specified. This is equivalent to NOT(EXCLUDES(values)). EXCLUDES matches when the value does not match any of the provided values, including null if explicitly specified. If null is not explicitly excluded, we include nulls in the result. BETWEEN matches when the value is between the two provided bounds (inclusive). Either bound can be null for an open-ended range. A null value matches only if a 3rd value of null is provided. BETWEEN applies to numeric, date and timestamp values.
              - one of `"includes"`, `"excludes"`, `"between"`
            - `value` (`<option>.filters.value`; FilterValueTypes, required)
              - any of the following:
                - `array<unknown>`
                  - any of the following:
                    - `integer`
                    - `null`
                - `array<unknown>`
                  - any of the following:
                    - `number`
                    - `null`
                - `array<any of>`
                  - any of the following:
                    - `string`
                    - `null`
                - `array<any of>`
                  - any of the following:
                    - `boolean`
                    - `null`
          - `design_url` (`<option>.design_url`; any of, optional) — Optional URL to a more detailed experiment design doc.
            - any of the following: `string`, `null`
          - `desired_n` (`<option>.desired_n`; any of, optional) — Desired number of individual participants. Required when creating individual-randomized preassigned experiments. For cluster-randomized preassigned experiment creation, use desired_n_clusters to control sampling; desired_n remains available for power calculations but is superseded by desired_n_clusters when both are set. When set, the power check also returns the minimum detectable effect for this size, along with the minimum sample size.
            - any of the following: `integer`, `null`
          - `desired_ns` (`<option>.desired_ns`; any of, optional) — Optional list of desired individual participant sample sizes. The power check returns the minimum detectable effect for each size (MetricPowerAnalysis.mde_curve), letting clients plot an MDE-vs-sample-size power curve from a single request. Superseded by desired_ns_clusters when both are set. Ignored when creating an experiment.
            - any of the following: `array<integer>`, `null`
          - `power` (`<option>.power`; number, optional) — The chance of detecting a real effect when one truly exists (1 - the false negative rate).
            - maximum: `1` · minimum: `0` · default: `0.8`
          - `alpha` (`<option>.alpha`; number, optional) — The chance of a false positive: concluding there is an effect when there is none.
            - maximum: `1` · minimum: `0` · default: `0.05`
          - `fstat_thresh` (`<option>.fstat_thresh`; number, optional) — The p-value threshold for the balance check. When the balance check's p-value is above this threshold, we treat the assignment as "balanced".
            - maximum: `1` · minimum: `0` · default: `0.6`
        - one of the following, each adding:
          - `OnlineFrequentistExperimentSpec` (`freq_online`)
            - `experiment_type` (`OnlineFrequentistExperimentSpec.experiment_type`; string, optional)
              - default: `"freq_online"`
          - `PreassignedFrequentistExperimentSpec` (`freq_preassigned`)
            - `experiment_type` (`PreassignedFrequentistExperimentSpec.experiment_type`; string, optional)
              - default: `"freq_preassigned"`
            - `cluster_key` (`PreassignedFrequentistExperimentSpec.cluster_key`; any of, optional) — Column name in table_name that identifies clusters for a cluster-randomized design. When set, per-metric icc, avg_cluster_size, and cv are either supplied on each metric or computed from this column at power_check time. When None, the design is assumed to be individual-randomized.
              - any of the following: `string`, `null`
            - `desired_n_clusters` (`PreassignedFrequentistExperimentSpec.desired_n_clusters`; any of, optional) — Desired number of clusters to sample when creating a cluster-randomized preassigned experiment. Required and only valid when cluster_key is set. All eligible participants in each sampled cluster are included. In power checks, the minimum detectable effect is computed for this many clusters, converted to a per-metric sample size using each metric's avg_cluster_size; takes precedence over desired_n.
              - any of the following: `integer`, `null`
            - `desired_ns_clusters` (`PreassignedFrequentistExperimentSpec.desired_ns_clusters`; any of, optional) — Optional list of desired cluster counts. Only valid when cluster_key is set. The power check returns the minimum detectable effect for each count (MetricPowerAnalysis.mde_curve), converted to a per-metric sample size using each metric's avg_cluster_size; takes precedence over desired_ns. Ignored when creating an experiment.
              - any of the following: `array<integer>`, `null`
      - `AnyFrequentistDesignSpec` (`freq_preassigned`)
        - every option has:
          - `experiment_name` (`<option>.experiment_name`; string, required)
            - maxLength: `100`
          - `description` (`<option>.description`; string, required)
            - maxLength: `2000`
          - `start_date` (`<option>.start_date`; string, required)
            - format: `date-time`
          - `end_date` (`<option>.end_date`; string, required)
            - format: `date-time`
          - `arms` (`<option>.arms`; array of object, required)
            - `arm_name` (`<option>.arms.arm_name`; string, required)
              - maxLength: `100`
            - `arm_id` (`<option>.arms.arm_id`; any of, optional) — Unique ID of the arm. Leave unset when creating an arm.
              - any of the following: `string`, `null`
            - `arm_description` (`<option>.arms.arm_description`; any of, optional)
              - any of the following: `string`, `null`
            - `arm_weight` (`<option>.arms.arm_weight`; any of, optional) — Optional weight for this arm, used for unequal allocation. The weight must be greater than 0 and less than 100. If you set a weight, all arms must have weights, and they must sum to 100.
              - any of the following: `ArmWeight`, `null`
          - `table_name` (`<option>.table_name`; string, required) — Data source table used to resolve participant field metadata.
            - maxLength: `100`
          - `primary_key` (`<option>.primary_key`; string, required) — Column name in table_name that uniquely identifies each participant.
            - maxLength: `300` · minLength: `1`
          - `strata` (`<option>.strata`; array of object, required) — Optional fields to use for stratified assignment.
            - `field_name` (`<option>.strata.field_name`; string, required)
              - maxLength: `300` · minLength: `1`
          - `metrics` (`<option>.metrics`; array of object, required) — Primary and optional secondary metrics to target.
            - `field_name` (`<option>.metrics.field_name`; string, required)
              - maxLength: `300` · minLength: `1`
            - `metric_pct_change` (`<option>.metrics.metric_pct_change`; any of, optional) — The smallest percent change, relative to metric_baseline, that you want to be able to detect. Cannot be set together with metric_target.
              - any of the following: `number`, `null`
            - `metric_target` (`<option>.metrics.metric_target`; any of, optional) — The absolute value you want to be able to detect. Cannot be set together with metric_pct_change.
              - any of the following: `number`, `null`
            - `icc` (`<option>.metrics.icc`; any of, optional) — Intracluster correlation coefficient for cluster-randomized designs.
              - any of the following: `number`, `null`
            - `avg_cluster_size` (`<option>.metrics.avg_cluster_size`; any of, optional) — Average number of participants per cluster.
              - any of the following: `number`, `null`
            - `cv` (`<option>.metrics.cv`; any of, optional) — Coefficient of variation in cluster sizes (0 = equal sizes).
              - any of the following: `number`, `null`
            - `metric_type` (`<option>.metrics.metric_type`; any of, optional) — Inferred from the data warehouse column type.
              - any of the following: `MetricType`, `null`
            - `metric_baseline` (`<option>.metrics.metric_baseline`; any of, optional) — Mean of the tracked metric.
              - any of the following: `number`, `null`
            - `metric_stddev` (`<option>.metrics.metric_stddev`; any of, optional) — Standard deviation is set only for MetricType.NUMERIC metrics. Must be set for numeric metrics when available_n > 0.
              - any of the following: `number`, `null`
            - `available_nonnull_n` (`<option>.metrics.available_nonnull_n`; any of, optional) — The number of participants who meet the filtering criteria and have a non-null value for this metric.
              - any of the following: `integer`, `null`
            - `available_n` (`<option>.metrics.available_n`; any of, optional) — The number of participants who meet the filtering criteria, whether or not this metric's value is NULL. Note: assignments are made from the available_n population. When available_n is greater than available_nonnull_n, some assigned participants may have a missing value for this metric.
              - any of the following: `integer`, `null`
            - `use_one_time_metric` (`<option>.metrics.use_one_time_metric`; boolean, optional) — Enable one-time metric mode: only assign participants with null values for this metric. Only allowed on the primary (first) metric of an individually-randomized preassigned experiment.
              - default: `false`
          - `filters` (`<option>.filters`; array of object, required) — Optional filters that narrow the eligible audience to the participants you want in the experiment.
            - `field_name` (`<option>.filters.field_name`; string, required)
              - maxLength: `300` · minLength: `1`
            - `relation` (`<option>.filters.relation`; string, required) — Defines operators for filtering values. INCLUDES matches when the value matches any of the provided values, including null if explicitly specified. This is equivalent to NOT(EXCLUDES(values)). EXCLUDES matches when the value does not match any of the provided values, including null if explicitly specified. If null is not explicitly excluded, we include nulls in the result. BETWEEN matches when the value is between the two provided bounds (inclusive). Either bound can be null for an open-ended range. A null value matches only if a 3rd value of null is provided. BETWEEN applies to numeric, date and timestamp values.
              - one of `"includes"`, `"excludes"`, `"between"`
            - `value` (`<option>.filters.value`; FilterValueTypes, required)
              - any of the following:
                - `array<unknown>`
                  - any of the following:
                    - `integer`
                    - `null`
                - `array<unknown>`
                  - any of the following:
                    - `number`
                    - `null`
                - `array<any of>`
                  - any of the following:
                    - `string`
                    - `null`
                - `array<any of>`
                  - any of the following:
                    - `boolean`
                    - `null`
          - `design_url` (`<option>.design_url`; any of, optional) — Optional URL to a more detailed experiment design doc.
            - any of the following: `string`, `null`
          - `desired_n` (`<option>.desired_n`; any of, optional) — Desired number of individual participants. Required when creating individual-randomized preassigned experiments. For cluster-randomized preassigned experiment creation, use desired_n_clusters to control sampling; desired_n remains available for power calculations but is superseded by desired_n_clusters when both are set. When set, the power check also returns the minimum detectable effect for this size, along with the minimum sample size.
            - any of the following: `integer`, `null`
          - `desired_ns` (`<option>.desired_ns`; any of, optional) — Optional list of desired individual participant sample sizes. The power check returns the minimum detectable effect for each size (MetricPowerAnalysis.mde_curve), letting clients plot an MDE-vs-sample-size power curve from a single request. Superseded by desired_ns_clusters when both are set. Ignored when creating an experiment.
            - any of the following: `array<integer>`, `null`
          - `power` (`<option>.power`; number, optional) — The chance of detecting a real effect when one truly exists (1 - the false negative rate).
            - maximum: `1` · minimum: `0` · default: `0.8`
          - `alpha` (`<option>.alpha`; number, optional) — The chance of a false positive: concluding there is an effect when there is none.
            - maximum: `1` · minimum: `0` · default: `0.05`
          - `fstat_thresh` (`<option>.fstat_thresh`; number, optional) — The p-value threshold for the balance check. When the balance check's p-value is above this threshold, we treat the assignment as "balanced".
            - maximum: `1` · minimum: `0` · default: `0.6`
        - one of the following, each adding:
          - `OnlineFrequentistExperimentSpec` (`freq_online`)
            - `experiment_type` (`OnlineFrequentistExperimentSpec.experiment_type`; string, optional)
              - default: `"freq_online"`
          - `PreassignedFrequentistExperimentSpec` (`freq_preassigned`)
            - `experiment_type` (`PreassignedFrequentistExperimentSpec.experiment_type`; string, optional)
              - default: `"freq_preassigned"`
            - `cluster_key` (`PreassignedFrequentistExperimentSpec.cluster_key`; any of, optional) — Column name in table_name that identifies clusters for a cluster-randomized design. When set, per-metric icc, avg_cluster_size, and cv are either supplied on each metric or computed from this column at power_check time. When None, the design is assumed to be individual-randomized.
              - any of the following: `string`, `null`
            - `desired_n_clusters` (`PreassignedFrequentistExperimentSpec.desired_n_clusters`; any of, optional) — Desired number of clusters to sample when creating a cluster-randomized preassigned experiment. Required and only valid when cluster_key is set. All eligible participants in each sampled cluster are included. In power checks, the minimum detectable effect is computed for this many clusters, converted to a per-metric sample size using each metric's avg_cluster_size; takes precedence over desired_n.
              - any of the following: `integer`, `null`
            - `desired_ns_clusters` (`PreassignedFrequentistExperimentSpec.desired_ns_clusters`; any of, optional) — Optional list of desired cluster counts. Only valid when cluster_key is set. The power check returns the minimum detectable effect for each count (MetricPowerAnalysis.mde_curve), converted to a per-metric sample size using each metric's avg_cluster_size; takes precedence over desired_ns. Ignored when creating an experiment.
              - any of the following: `array<integer>`, `null`
      - `AnyBanditDesignSpec` (`mab_online`)
        - every option has:
          - `experiment_name` (`<option>.experiment_name`; string, required)
            - maxLength: `100`
          - `description` (`<option>.description`; string, required)
            - maxLength: `2000`
          - `start_date` (`<option>.start_date`; string, required)
            - format: `date-time`
          - `end_date` (`<option>.end_date`; string, required)
            - format: `date-time`
          - `arms` (`<option>.arms`; array of object, required)
            - `arm_name` (`<option>.arms.arm_name`; string, required)
              - maxLength: `100`
            - `arm_id` (`<option>.arms.arm_id`; any of, optional) — Unique ID of the arm. Leave unset when creating an arm.
              - any of the following: `string`, `null`
            - `arm_description` (`<option>.arms.arm_description`; any of, optional)
              - any of the following: `string`, `null`
            - `arm_weight` (`<option>.arms.arm_weight`; any of, optional) — Optional weight for this arm, used for unequal allocation. The weight must be greater than 0 and less than 100. If you set a weight, all arms must have weights, and they must sum to 100.
              - any of the following: `ArmWeight`, `null`
            - `alpha_init` (`<option>.arms.alpha_init`; any of, optional) — Initial alpha parameter for the Beta prior.
              - any of the following: `number`, `null`
            - `beta_init` (`<option>.arms.beta_init`; any of, optional) — Initial beta parameter for the Beta prior.
              - any of the following: `number`, `null`
            - `mu_init` (`<option>.arms.mu_init`; any of, optional) — Initial mean parameter for the Normal prior.
              - any of the following: `number`, `null`
            - `sigma_init` (`<option>.arms.sigma_init`; any of, optional) — Initial standard deviation parameter for the Normal prior.
              - any of the following: `number`, `null`
            - `alpha` (`<option>.arms.alpha`; any of, optional) — Updated alpha parameter for the Beta prior.
              - any of the following: `number`, `null`
            - `beta` (`<option>.arms.beta`; any of, optional) — Updated beta parameter for the Beta prior.
              - any of the following: `number`, `null`
            - `mu` (`<option>.arms.mu`; any of, optional) — Updated mean vector for the Normal prior.
              - any of the following: `array<number>`, `null`
            - `covariance` (`<option>.arms.covariance`; any of, optional) — Updated covariance matrix for the Normal prior.
              - any of the following: `array<array<number>>`, `null`
          - `design_url` (`<option>.design_url`; any of, optional) — Optional URL to a more detailed experiment design doc.
            - any of the following: `string`, `null`
          - `contexts` (`<option>.contexts`; any of, optional) — Optional list of contexts that can be used to condition the assignment. Required for Contextual Multi-armed Bandit (CMAB) experiments.
            - any of the following:
              - `array<unknown>`
                - `context_name` (`<option>.contexts.1.context_name`; string, required)
                  - maxLength: `100`
                - `context_id` (`<option>.contexts.1.context_id`; any of, optional) — Unique identifier for the context. Do not set this when you create a new context.
                  - any of the following: `string`, `null`
                - `context_description` (`<option>.contexts.1.context_description`; any of, optional)
                  - any of the following: `string`, `null`
                - `value_type` (`<option>.contexts.1.value_type`; string, optional) — Type of value the context can take.
                  - one of `"binary"`, `"real-valued"` · default: `"binary"`
              - `null`
          - `prior_type` (`<option>.prior_type`; string, optional) — The type of prior distribution for the arms.
            - one of `"beta"`, `"normal"` · default: `"beta"`
          - `reward_type` (`<option>.reward_type`; string, optional) — The type of outcome observed from the experiment.
            - one of `"binary"`, `"real-valued"` · default: `"binary"`
          - `enable_autofail` (`<option>.enable_autofail`; boolean, optional) — When true, Evidential records a failure for participants whose outcome does not arrive (via either push or pull) within a specified time window.
            - default: `false`
          - `autofail_window` (`<option>.autofail_window`; integer, optional) — The time window in hours after which a participant is considered to have failed if no outcome arrives (via either push or pull). Default is 24 hours. Required if enable_autofail is true.
            - minimum: `1` · default: `24`
          - `autofail_outcome_value` (`<option>.autofail_outcome_value`; number, optional) — The outcome value to assign to participants who are automatically failed. Required if enable_autofail is true.
            - default: `0`
        - one of the following, each adding:
          - `CMABExperimentSpec` (`cmab_online`)
            - `experiment_type` (`CMABExperimentSpec.experiment_type`; string, optional)
              - default: `"cmab_online"`
          - `MABExperimentSpec` (`mab_online`)
            - `experiment_type` (`MABExperimentSpec.experiment_type`; string, optional)
              - default: `"mab_online"`
          - `MABDwhExperimentSpec` (`mab_online_dwh`)
            - `table_name` (`MABDwhExperimentSpec.table_name`; string, required) — Datasource table used to resolve target field metadata.
              - maxLength: `100`
            - `primary_key` (`MABDwhExperimentSpec.primary_key`; string, required) — Column name in table_name that uniquely identifies each participant.
              - maxLength: `300` · minLength: `1`
            - `target_field_name` (`MABDwhExperimentSpec.target_field_name`; string, required) — Column name in table_name whose values this bandit optimises. Its data type is resolved from the DWH at create-time and used to validate subsequent outcome reports.
              - maxLength: `300` · minLength: `1`
            - `experiment_type` (`MABDwhExperimentSpec.experiment_type`; string, optional)
              - default: `"mab_online_dwh"`
      - `AnyBanditDesignSpec` (`mab_online_dwh`)
        - every option has:
          - `experiment_name` (`<option>.experiment_name`; string, required)
            - maxLength: `100`
          - `description` (`<option>.description`; string, required)
            - maxLength: `2000`
          - `start_date` (`<option>.start_date`; string, required)
            - format: `date-time`
          - `end_date` (`<option>.end_date`; string, required)
            - format: `date-time`
          - `arms` (`<option>.arms`; array of object, required)
            - `arm_name` (`<option>.arms.arm_name`; string, required)
              - maxLength: `100`
            - `arm_id` (`<option>.arms.arm_id`; any of, optional) — Unique ID of the arm. Leave unset when creating an arm.
              - any of the following: `string`, `null`
            - `arm_description` (`<option>.arms.arm_description`; any of, optional)
              - any of the following: `string`, `null`
            - `arm_weight` (`<option>.arms.arm_weight`; any of, optional) — Optional weight for this arm, used for unequal allocation. The weight must be greater than 0 and less than 100. If you set a weight, all arms must have weights, and they must sum to 100.
              - any of the following: `ArmWeight`, `null`
            - `alpha_init` (`<option>.arms.alpha_init`; any of, optional) — Initial alpha parameter for the Beta prior.
              - any of the following: `number`, `null`
            - `beta_init` (`<option>.arms.beta_init`; any of, optional) — Initial beta parameter for the Beta prior.
              - any of the following: `number`, `null`
            - `mu_init` (`<option>.arms.mu_init`; any of, optional) — Initial mean parameter for the Normal prior.
              - any of the following: `number`, `null`
            - `sigma_init` (`<option>.arms.sigma_init`; any of, optional) — Initial standard deviation parameter for the Normal prior.
              - any of the following: `number`, `null`
            - `alpha` (`<option>.arms.alpha`; any of, optional) — Updated alpha parameter for the Beta prior.
              - any of the following: `number`, `null`
            - `beta` (`<option>.arms.beta`; any of, optional) — Updated beta parameter for the Beta prior.
              - any of the following: `number`, `null`
            - `mu` (`<option>.arms.mu`; any of, optional) — Updated mean vector for the Normal prior.
              - any of the following: `array<number>`, `null`
            - `covariance` (`<option>.arms.covariance`; any of, optional) — Updated covariance matrix for the Normal prior.
              - any of the following: `array<array<number>>`, `null`
          - `design_url` (`<option>.design_url`; any of, optional) — Optional URL to a more detailed experiment design doc.
            - any of the following: `string`, `null`
          - `contexts` (`<option>.contexts`; any of, optional) — Optional list of contexts that can be used to condition the assignment. Required for Contextual Multi-armed Bandit (CMAB) experiments.
            - any of the following:
              - `array<unknown>`
                - `context_name` (`<option>.contexts.1.context_name`; string, required)
                  - maxLength: `100`
                - `context_id` (`<option>.contexts.1.context_id`; any of, optional) — Unique identifier for the context. Do not set this when you create a new context.
                  - any of the following: `string`, `null`
                - `context_description` (`<option>.contexts.1.context_description`; any of, optional)
                  - any of the following: `string`, `null`
                - `value_type` (`<option>.contexts.1.value_type`; string, optional) — Type of value the context can take.
                  - one of `"binary"`, `"real-valued"` · default: `"binary"`
              - `null`
          - `prior_type` (`<option>.prior_type`; string, optional) — The type of prior distribution for the arms.
            - one of `"beta"`, `"normal"` · default: `"beta"`
          - `reward_type` (`<option>.reward_type`; string, optional) — The type of outcome observed from the experiment.
            - one of `"binary"`, `"real-valued"` · default: `"binary"`
          - `enable_autofail` (`<option>.enable_autofail`; boolean, optional) — When true, Evidential records a failure for participants whose outcome does not arrive (via either push or pull) within a specified time window.
            - default: `false`
          - `autofail_window` (`<option>.autofail_window`; integer, optional) — The time window in hours after which a participant is considered to have failed if no outcome arrives (via either push or pull). Default is 24 hours. Required if enable_autofail is true.
            - minimum: `1` · default: `24`
          - `autofail_outcome_value` (`<option>.autofail_outcome_value`; number, optional) — The outcome value to assign to participants who are automatically failed. Required if enable_autofail is true.
            - default: `0`
        - one of the following, each adding:
          - `CMABExperimentSpec` (`cmab_online`)
            - `experiment_type` (`CMABExperimentSpec.experiment_type`; string, optional)
              - default: `"cmab_online"`
          - `MABExperimentSpec` (`mab_online`)
            - `experiment_type` (`MABExperimentSpec.experiment_type`; string, optional)
              - default: `"mab_online"`
          - `MABDwhExperimentSpec` (`mab_online_dwh`)
            - `table_name` (`MABDwhExperimentSpec.table_name`; string, required) — Datasource table used to resolve target field metadata.
              - maxLength: `100`
            - `primary_key` (`MABDwhExperimentSpec.primary_key`; string, required) — Column name in table_name that uniquely identifies each participant.
              - maxLength: `300` · minLength: `1`
            - `target_field_name` (`MABDwhExperimentSpec.target_field_name`; string, required) — Column name in table_name whose values this bandit optimises. Its data type is resolved from the DWH at create-time and used to validate subsequent outcome reports.
              - maxLength: `300` · minLength: `1`
            - `experiment_type` (`MABDwhExperimentSpec.experiment_type`; string, optional)
              - default: `"mab_online_dwh"`
    - discriminator: `experiment_type`
  - `power_analyses` (`list_experiments.response.200.items.power_analyses`; any of, required)
    - any of the following:
      - `PowerResponse`
        - `analyses` (`PowerResponse.analyses`; array of object, required)
          - `metric_spec` (`PowerResponse.analyses.metric_spec`; object, required) — Defines a metric to measure in an experiment with its baseline stats. Adds the fields only the server can derive from the data, so request and response metrics stay separate types (and separate OpenAPI schemas).
            - `field_name` (`PowerResponse.analyses.metric_spec.field_name`; string, required)
              - maxLength: `300` · minLength: `1`
            - `metric_pct_change` (`PowerResponse.analyses.metric_spec.metric_pct_change`; any of, optional) — Percent change target relative to the metric_baseline.
              - any of the following: `number`, `null`
            - `metric_target` (`PowerResponse.analyses.metric_spec.metric_target`; any of, optional) — Absolute target value = metric_baseline * (1 + metric_pct_change).
              - any of the following: `number`, `null`
            - `icc` (`PowerResponse.analyses.metric_spec.icc`; any of, optional) — Intracluster correlation coefficient for cluster-randomized designs.
              - any of the following: `number`, `null`
            - `avg_cluster_size` (`PowerResponse.analyses.metric_spec.avg_cluster_size`; any of, optional) — Average number of participants per cluster.
              - any of the following: `number`, `null`
            - `cv` (`PowerResponse.analyses.metric_spec.cv`; any of, optional) — Coefficient of variation in cluster sizes (0 = equal sizes).
              - any of the following: `number`, `null`
            - `metric_type` (`PowerResponse.analyses.metric_spec.metric_type`; any of, optional) — Inferred from the data warehouse column type.
              - any of the following: `MetricType`, `null`
            - `metric_baseline` (`PowerResponse.analyses.metric_spec.metric_baseline`; any of, optional) — Mean of the tracked metric.
              - any of the following: `number`, `null`
            - `metric_stddev` (`PowerResponse.analyses.metric_spec.metric_stddev`; any of, optional) — Standard deviation is set only for MetricType.NUMERIC metrics. Must be set for numeric metrics when available_n > 0.
              - any of the following: `number`, `null`
            - `available_nonnull_n` (`PowerResponse.analyses.metric_spec.available_nonnull_n`; any of, optional) — The number of participants who meet the filtering criteria and have a non-null value for this metric.
              - any of the following: `integer`, `null`
            - `available_n` (`PowerResponse.analyses.metric_spec.available_n`; any of, optional) — The number of participants who meet the filtering criteria, whether or not this metric's value is NULL. Note: assignments are made from the available_n population. When available_n is greater than available_nonnull_n, some assigned participants may have a missing value for this metric.
              - any of the following: `integer`, `null`
            - `use_one_time_metric` (`PowerResponse.analyses.metric_spec.use_one_time_metric`; boolean, optional) — Enable one-time metric mode: only assign participants with null values for this metric. Only allowed on the primary (first) metric of an individually-randomized preassigned experiment.
              - default: `false`
            - `is_one_time_eligible` (`PowerResponse.analyses.metric_spec.is_one_time_eligible`; boolean, optional) — Set by the power check: True if the metric is eligible for one-time mode (it is the primary metric and its column has both null and non-null values).
              - default: `false`
          - `target_n` (`PowerResponse.analyses.target_n`; any of, optional) — Minimum sample size needed to meet the design specs.
            - any of the following: `integer`, `null`
          - `sufficient_n` (`PowerResponse.analyses.sufficient_n`; any of, optional) — Whether there are enough available participants to sample to reach target_n.
            - any of the following: `boolean`, `null`
          - `target_possible` (`PowerResponse.analyses.target_possible`; any of, optional) — When the sample size is too small to reach the desired metric_target, this is the target that is possible given available_n, in the improvement (positive) direction from the baseline. It is the absolute counterpart of pct_change_possible. None when the sample size is large enough to detect the desired change, or (for BINARY metrics) when no value above the baseline is a large enough change to reach the requested power.
            - any of the following: `number`, `null`
          - `pct_change_possible` (`PowerResponse.analyses.pct_change_possible`; any of, optional) — When the sample size is too small to reach the desired metric_pct_change, this is the percent change that is possible given available_n. It is the relative counterpart of target_possible. None whenever target_possible is None.
            - any of the following: `number`, `null`
          - `target_possible_lower` (`PowerResponse.analyses.target_possible_lower`; any of, optional) — The detectable metric value below the baseline. (target_possible is the metric value above the baseline.) Both detectable metric values above and below the baseline use the chosen confidence and power, and are always reported together, regardless of the direction of the requested change. For numeric metrics, this is the same distance below the baseline as target_possible is above it. However, for binary metrics, an increase and a decrease that are equally detectable can sit at different distances from the baseline. None when the sample size is large enough to detect the desired change, or (for BINARY metrics) when no value below the baseline is a large enough change to reach the requested power.
            - any of the following: `number`, `null`
          - `pct_change_possible_lower` (`PowerResponse.analyses.pct_change_possible_lower`; any of, optional) — The relative counterpart of target_possible_lower, as a percent change from the baseline (negative for a decrease). A value of -0.10 means a 10% decrease. None whenever target_possible_lower is None.
            - any of the following: `number`, `null`
          - `pct_change_with_desired_n` (`PowerResponse.analyses.pct_change_with_desired_n`; any of, optional) — The minimum detectable effect (MDE) achievable for the desired sample size at the chosen confidence and power, reported in the direction of the requested change (negative when the requested change is a decrease from the baseline). Present only when design_spec.desired_n or design_spec.desired_n_clusters is set (frequentist design specs). When desired_n_clusters is set, the desired sample size is desired_n_clusters times this metric's avg_cluster_size.
            - any of the following: `number`, `null`
          - `mde_curve` (`PowerResponse.analyses.mde_curve`; any of, optional) — The MDE for each requested sample size, in the same order as design_spec.desired_ns (or desired_ns_clusters, which takes precedence). Present only when one of those is set. Each point is computed best-effort: a size where the calculation fails yields a null pct_change instead of failing the request.
            - any of the following:
              - `array<unknown>`
                - `desired_n` (`PowerResponse.analyses.mde_curve.1.desired_n`; integer, required) — Sample size in individual participants used for this point. For cluster-randomized designs this is desired_n_clusters times the metric's avg_cluster_size.
                - `desired_n_clusters` (`PowerResponse.analyses.mde_curve.1.desired_n_clusters`; any of, optional) — The requested number of clusters for this point. None for individual-randomized requests.
                  - any of the following: `integer`, `null`
                - `pct_change` (`PowerResponse.analyses.mde_curve.1.pct_change`; any of, optional) — The minimum detectable effect (MDE) at this sample size, as a percent change relative to metric_baseline. None when the power calculation fails at this size (e.g. too small to solve).
                  - any of the following: `number`, `null`
              - `null`
          - `msg` (`PowerResponse.analyses.msg`; any of, optional) — A human-friendly summary of the power analysis results.
            - any of the following: `MetricPowerAnalysisMessage`, `null`
          - `num_clusters_total` (`PowerResponse.analyses.num_clusters_total`; any of, optional) — Total number of clusters needed across all arms.
            - any of the following: `integer`, `null`
          - `clusters_per_arm` (`PowerResponse.analyses.clusters_per_arm`; any of, optional) — Number of clusters needed for each arm (one entry per arm).
            - any of the following: `array<integer>`, `null`
          - `n_per_arm` (`PowerResponse.analyses.n_per_arm`; any of, optional) — Number of participants for each arm (one entry per arm).
            - any of the following: `array<integer>`, `null`
          - `design_effect` (`PowerResponse.analyses.design_effect`; any of, optional) — Design effect (DEFF), the clustering penalty multiplier.
            - any of the following: `number`, `null`
          - `effective_sample_size` (`PowerResponse.analyses.effective_sample_size`; any of, optional) — Effective sample size accounting for clustering (total_n / DEFF).
            - any of the following: `integer`, `null`
      - `null`
  - `assign_summary` (`list_experiments.response.200.items.assign_summary`; any of, required)
    - any of the following:
      - `AssignSummary`
        - `sample_size` (`AssignSummary.sample_size`; integer, required) — The number of participants across all arms in total.
        - `balance_check` (`AssignSummary.balance_check`; any of, optional) — Balance test results if available. Online experiments do not have balance checks.
          - any of the following: `BalanceCheck`, `null`
        - `arm_sizes` (`AssignSummary.arm_sizes`; any of, optional) — For each arm, the number of participants (and optionally clusters) assigned.
          - any of the following:
            - `array<unknown>`
              - `arm` (`AssignSummary.arm_sizes.1.arm`; object, required) — Describes an experiment treatment arm.
                - `arm_name` (`AssignSummary.arm_sizes.1.arm.arm_name`; string, required)
                  - maxLength: `100`
                - `arm_id` (`AssignSummary.arm_sizes.1.arm.arm_id`; any of, optional) — Unique ID of the arm. Leave unset when creating an arm.
                  - any of the following: `string`, `null`
                - `arm_description` (`AssignSummary.arm_sizes.1.arm.arm_description`; any of, optional)
                  - any of the following: `string`, `null`
                - `arm_weight` (`AssignSummary.arm_sizes.1.arm.arm_weight`; any of, optional) — Optional weight for this arm, used for unequal allocation. The weight must be greater than 0 and less than 100. If you set a weight, all arms must have weights, and they must sum to 100.
                  - any of the following: `ArmWeight`, `null`
              - `size` (`AssignSummary.arm_sizes.1.size`; integer, optional)
                - default: `0`
              - `cluster_count` (`AssignSummary.arm_sizes.1.cluster_count`; any of, optional) — The number of clusters assigned to this arm. Set only on cluster-randomized experiments.
                - any of the following: `integer`, `null`
            - `null`
      - `null`
  - `spreadsheet_full_url` (`list_experiments.response.200.items.spreadsheet_full_url`; any of, optional) — Full URL of the datasource spreadsheet, including the launched experiment's outcomes tab.
    - any of the following: `string`, `null`
  - `webhooks` (`list_experiments.response.200.items.webhooks`; array of string, optional) — List of webhook IDs associated with this experiment. These webhooks are triggered when the experiment is committed.
    - default: `[]`
  - `decision` (`list_experiments.response.200.items.decision`; string, optional) — Record any decision(s) made because of this experiment. Will you launch it, and if so when? Regardless of positive or negative results, how do any learnings inform next steps or future hypotheses?
    - default: `""`
  - `impact` (`list_experiments.response.200.items.impact`; string, optional) — Given the results across your tracked metrics and any other observed effects seen elsewhere, record an overall summary here. Do they agree or reject your hypotheses? Beyond the metrics tracked, did variations affect scalability, cost, feedback, or other aspects?
    - one of `"high"`, `"medium"`, `"low"`, `"negative"`, `"unclear"`, `""` · default: `""`

### 400

The request is invalid. Check that the request body matches the required structure and that all required fields and headers are present.

#### Example

```json
{}
```

### 403

You did not provide a valid API key, or your API key does not have permission for this operation.

Tip: Check that the API key in the `X-API-Key` header has access to the data source or experiment.

#### Example

```json
{}
```

### 404

The resource was not found, or you do not have access to it.

Tip: Check that the API key in the `X-API-Key` header has access to the data source or experiment.

#### Example

```json
{}
```

### 422

Validation Error

#### Example

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}
```

- `detail` (`list_experiments.response.422.detail`; array of object, optional)
  - `loc` (`list_experiments.response.422.detail.loc`; array\<any of\>, required)
    - any of the following: `string`, `integer`
  - `msg` (`list_experiments.response.422.detail.msg`; string, required)
  - `type` (`list_experiments.response.422.detail.type`; string, required)
  - `input` (`list_experiments.response.422.detail.input`; unknown, optional)
  - `ctx` (`list_experiments.response.422.detail.ctx`; object, optional)


Source: https://docs.evidential.dev/api/experiments/list/index.md
