---
title: Get experiment
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > API Reference > Experiments
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

{% callout %}
# Important note for users on the following Datadog sites: app.ddog-gov.com, us2.ddog-gov.com

{% alert level="danger" %}
This product is not supported for your selected [Datadog site](https://docs.datadoghq.com/getting_started/site.md). ({% placeholder "user-datadog-site-name" /%}).
{% /alert %}

{% /callout %}

# Get experiment{% #get-experiment %}

{% tab title="v2" %}

| Datadog site      | API endpoint                                                         |
| ----------------- | -------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/experiments/{experiment_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/experiments/{experiment_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/experiments/{experiment_id}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/experiments/{experiment_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/experiments/{experiment_id}  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/experiments/{experiment_id} |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/experiments/{experiment_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/experiments/{experiment_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/experiments/{experiment_id} |

### Overview

Get a complete experiment by ID. The response includes structured metadata, related links, and, when a complete setup exists, decision metrics, variants, `warehouse_exposure_configuration`, `datadog_flag_configuration`, STATIC or STEPS traffic exposure, and assignment and event dates. STEPS describes the configured plan rather than wall-clock history; Datadog step durations exclude pauses. The list endpoint omits these setup details. This endpoint requires the `product_analytics_experiments_read` permission.

OAuth apps require the `product_analytics_experiments_read` authorization [scope](https://docs.datadoghq.com/api/latest/scopes.md#experiments) to access this endpoint.



### Arguments

#### Path Parameters

| Name                            | Type   | Description                 |
| ------------------------------- | ------ | --------------------------- |
| experiment_id [*required*] | string | The UUID of the experiment. |

### Response

{% tab title="200" %}
OK
{% tab title="Model" %}
Response containing an experiment and its configuration.

| Parent field                     | Field                                   | Type            | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| -------------------------------- | --------------------------------------- | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|                                  | data [*required*]                  | object          | Experiment resource with its identifier and configuration.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| data                             | attributes                              | object          | Details of the experiment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| attributes                       | assignments_end_date                    | date-time       | End of the time window for experiment assignments.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| attributes                       | assignments_start_date                  | date-time       | Start of the time window for experiment assignments.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| attributes                       | concluded_at                            | date-time       | Time when the experiment was concluded.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| attributes                       | conclusion                              | object          | Outcome and supporting text recorded when the experiment is concluded.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| conclusion                       | decision_reason                         | string          | Reason for the recorded decision.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| conclusion                       | outcome                                 | enum            | Recorded experiment outcome. Allowed enum values: `POSITIVE,NEGATIVE,NEUTRAL,INCONCLUSIVE,MISCONFIGURED,UNKNOWN`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| conclusion                       | summary                                 | string          | Summary of the experiment conclusion.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| attributes                       | created_at                              | date-time       | Time when this resource was created.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| attributes                       | datadog_flag_configuration              | object          | Feature flag, environment, and targeting configuration for the experiment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| datadog_flag_configuration       | allocation_key                          | string          | Key of the feature flag allocation linked to the experiment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| datadog_flag_configuration       | entry_point [*required*]           | object          | Datadog measure and filters used to select analyzed subjects.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| entry_point                      | filters [*required*]               | [array]         | Complete Datadog OR-of-ANDs entry-point filter expression.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| entry_point                      | measure_id [*required*]            | string          | Datadog measure UUID.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| datadog_flag_configuration       | environment_id                          | string          | ID of the feature flag environment used by the experiment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| datadog_flag_configuration       | feature_flag_id                         | string          | ID of the feature flag linked to the experiment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| datadog_flag_configuration       | targeting_rules                         | [object]        | Rules that select subjects for the experiment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| targeting_rules                  | conditions [*required*]            | [ <oneOf>] | Conditions that must all match for this rule. Each condition must use exactly one shape: saved_filter_id alone or operator plus attribute plus value.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| conditions                       | Object 1                                | object          | A condition that uses a saved filter. Inline fields must be omitted or null.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Object 1                         | saved_filter_id [*required*]       | uuid            | Saved-filter UUID.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| conditions                       | Object 2                                | object          | An inline condition. The saved_filter_id field must be omitted or null.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Object 2                         | attribute [*required*]             | string          | Attribute to evaluate.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Object 2                         | operator [*required*]              | enum            | Required with attribute and value for an inline condition; omit when saved_filter_id is set. Allowed enum values: `LT,LTE,GT,GTE,MATCHES,NOT_MATCHES,ONE_OF,NOT_ONE_OF,IS_NULL,EQUALS`                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Object 2                         | value [*required*]                 | [string]        | Values used by the operator. Every operator requires at least one value.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| attributes                       | decision_metrics                        | [object]        | Metrics used to decide the experiment outcome.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| decision_metrics                 | is_primary [*required*]            | boolean         | Whether this is the experiment primary metric.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| decision_metrics                 | metric_id [*required*]             | uuid            | Decision metric UUID.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| attributes                       | decision_variant_key                    | string          | Key of the variant selected in the experiment decision.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| attributes                       | events_end_date                         | date-time       | End of the time window for metric events.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| attributes                       | events_start_date                       | date-time       | Start of the time window for metric events.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| attributes                       | experiment_type                         | string          | Kind of experiment. STANDARD is an ordinary experiment. Other values, such as CANARY and HOLDOUT, identify experiments owned by another workflow. New kinds may be added; treat unknown values as non-standard.                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| attributes                       | hypothesis                              | string          | Expected effect that the experiment is intended to test.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| attributes                       | migration_metadata                      |                 | Metadata retained for resources imported from another system.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| attributes                       | name                                    | string          | Display name of the experiment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| attributes                       | pipeline_table_suffix                   | string          | Suffix used to identify the experiment's pipeline output table.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| attributes                       | protocol_id                             | string          | ID of the protocol associated with the experiment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| attributes                       | related_links                           | [object]        | Links to supporting material for the experiment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| related_links                    | id                                      | string          | Link ID. Omit it when adding a link.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| related_links                    | title                                   | string          | Optional display title.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| related_links                    | url [*required*]                   | string          | Absolute URL.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| attributes                       | results_last_updated                    | date-time       | Time of the most recent update to the experiment's results.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| attributes                       | split_by_properties                     | [object]        | Properties used to split the experiment results into groups.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| split_by_properties              | column_name [*required*]           | string          | Exposure field or Warehouse column used for the analysis dimension.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| split_by_properties              | column_type [*required*]           | enum            | Type of the Datadog exposure field or Warehouse column. Allowed enum values: `varchar,int,double,boolean,varchar_array,int_array,double_array,raw,STRING,INTEGER`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| split_by_properties              | id [*required*]                    | string          | Read-only property ID. Omit it from POST and PATCH; writes identify properties by column_name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| split_by_properties              | name [*required*]                  | string          | Display name for the analysis dimension.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| attributes                       | status                                  | enum            | Current stage in the experiment lifecycle. Allowed enum values: `DRAFT,SCHEDULED,IN_PROGRESS,READY_FOR_DECISION,DECISION_MADE,CANCELLED,UNKNOWN`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| attributes                       | structured_metadata                     | [object]        | Values of structured metadata fields attached to the experiment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| structured_metadata              | enum_values                             | [string]        | Selected values for an enumerated metadata field.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| structured_metadata              | field_display_name                      | string          | Display name of the metadata field.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| structured_metadata              | field_key [*required*]             | string          | Key that identifies the metadata field.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| structured_metadata              | field_type                              | enum            | Type of value stored in the structured metadata field. Allowed enum values: `FREETEXT,ENUM`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| structured_metadata              | freetext_value                          | string          | Text value for a free-text metadata field.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| attributes                       | subject_type_id                         | string          | ID of the subject type used by this configuration.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| attributes                       | summary                                 | string          | Summary text recorded for the experiment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| attributes                       | tags                                    | [string]        | Tags attached to the experiment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| attributes                       | teams                                   | [string]        | Teams associated with the experiment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| attributes                       | traffic_exposure                        | object          | Traffic exposure fraction or schedule configured for the experiment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| traffic_exposure                 | fraction                                | double          | STATIC exposure fraction. Draft experiments can change this value. After start only warehouse experiments without a Datadog flag can change a STATIC fraction through the public API.                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| traffic_exposure                 | mode [*required*]                  | enum            | Whether exposure uses a fixed fraction or a sequence of steps. Allowed enum values: `STATIC,STEPS`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| traffic_exposure                 | steps                                   | [object]        | Configured exposure plan rather than wall-clock history. At least two steps must have strictly increasing fractions and no gaps. Warehouse steps start at assignments_start_date and can use different durations. New Datadog plans have at most five steps and a first fraction above zero. Their nonfinal durations must be equal and exclude time paused. Datadog steps start with the experiment. Running warehouse experiments can replace step fractions, durations, and the exposure mode. After start, Datadog exposure plans cannot change through the public API. The final duration is null and its fraction holds until assignment ends. |
| steps                            | duration_ms [*required*]           | int64           | Positive step duration in milliseconds. Datadog durations exclude pauses. Send null for the final step.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| steps                            | fraction [*required*]              | double          | Fraction of traffic exposed during this step.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| attributes                       | updated_at                              | date-time       | Time when this resource was last updated.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| attributes                       | variants                                | [object]        | Variants configured for the experiment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| variants                         | feature_flag_variant_id                 | string          | Backing feature flag variant ID. Present for Datadog feature flag experiments and omitted for Warehouse experiments.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| variants                         | is_active [*required*]             | boolean         | Whether this variant participates in the experiment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| variants                         | is_control [*required*]            | boolean         | Whether this is the single control variant.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| variants                         | key [*required*]                   | string          | Value recorded in exposure data for this variant.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| variants                         | name                                    | string          | Display name of the experiment variant.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| variants                         | weight [*required*]                | double          | Traffic allocation percentage.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| attributes                       | warehouse_exposure_configuration        | object          | Warehouse exposure model and settings used to identify experiment assignments.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| warehouse_exposure_configuration | entry_point [*required*]           | object          | Optional Warehouse measure that scopes analyzed subjects.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| entry_point                      | filters [*required*]               | [object]        | Complete ordered Warehouse entry-point filter set.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| filters                          | operation [*required*]             | enum            | Comparison applied by the warehouse entry-point filter. Allowed enum values: `IS,IS_NOT`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| filters                          | property_id [*required*]           | string          | Warehouse property UUID.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| filters                          | values [*required*]                | [string]        | Ordered values used by the filter.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| entry_point                      | measure_id [*required*]            | string          | Warehouse measure UUID.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| warehouse_exposure_configuration | experiment_key [*required*]        | string          | Warehouse experiment key. Reads can return null for incomplete configuration; configuration writes require a value.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| warehouse_exposure_configuration | exposure_sql_model_id [*required*] | string          | ID of the exposure SQL model that provides assignment data.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| data                             | id [*required*]                    | uuid            | Identifier of the experiment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| data                             | type [*required*]                  | enum            | Experiments resource type. Allowed enum values: `experiments`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

{% /tab %}

{% tab title="Example" %}

```json
{
  "data": {
    "attributes": {
      "assignments_end_date": "2026-08-15T00:00:00Z",
      "assignments_start_date": "2026-08-01T00:00:00Z",
      "concluded_at": "2026-08-05T09:30:00Z",
      "conclusion": {
        "decision_reason": "The primary metric improved without material regressions",
        "outcome": "POSITIVE",
        "summary": "The treatment improved conversion"
      },
      "created_at": "2026-08-01T12:00:00Z",
      "datadog_flag_configuration": null,
      "decision_metrics": [
        {
          "is_primary": true,
          "metric_id": "b1a2c3d4-0000-0000-0000-000000000000"
        }
      ],
      "decision_variant_key": "treatment",
      "events_end_date": "2026-08-22T00:00:00Z",
      "events_start_date": "2026-08-01T00:00:00Z",
      "experiment_type": "STANDARD",
      "hypothesis": "A clearer checkout button increases purchase conversion",
      "name": "Checkout button test",
      "pipeline_table_suffix": "a1b2c3d4",
      "protocol_id": "e4d5f6a7-0000-0000-0000-000000000000",
      "related_links": [
        {
          "id": "d1d2d3d4-0000-0000-0000-000000000000",
          "title": "Experiment design",
          "url": "https://docs.example.com/checkout-experiment"
        }
      ],
      "results_last_updated": "2026-08-05T09:25:00Z",
      "split_by_properties": [],
      "status": "DECISION_MADE",
      "structured_metadata": [
        {
          "enum_values": [
            "beta"
          ],
          "field_display_name": "Launch stage",
          "field_key": "launch_stage",
          "field_type": "ENUM"
        },
        {
          "field_display_name": "Notes",
          "field_key": "notes",
          "field_type": "FREETEXT",
          "freetext_value": "Checkout redesign"
        }
      ],
      "subject_type_id": "c2b3d4e5-0000-0000-0000-000000000000",
      "summary": "The treatment improved conversion",
      "tags": [
        "growth"
      ],
      "teams": [
        "growth"
      ],
      "traffic_exposure": {
        "fraction": 1,
        "mode": "STATIC"
      },
      "updated_at": "2026-08-05T09:30:00Z",
      "variants": [
        {
          "is_active": true,
          "is_control": true,
          "key": "control",
          "name": "Control",
          "weight": 50
        },
        {
          "is_active": true,
          "is_control": false,
          "key": "treatment",
          "name": "Treatment",
          "weight": 50
        }
      ],
      "warehouse_exposure_configuration": {
        "entry_point": null,
        "experiment_key": "checkout_button_test",
        "exposure_sql_model_id": "f5e6a7b8-0000-0000-0000-000000000000"
      }
    },
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "experiments"
  }
}
```

{% /tab %}

{% /tab %}

{% tab title="400" %}
Malformed experiment ID (not a valid UUID).
{% tab title="Model" %}
API error response.

| Parent field | Field                    | Type     | Description                                                                     |
| ------------ | ------------------------ | -------- | ------------------------------------------------------------------------------- |
|              | errors [*required*] | [object] | A list of errors.                                                               |
| errors       | detail                   | string   | A human-readable explanation specific to this occurrence of the error.          |
| errors       | meta                     | object   | Non-standard meta-information about the error                                   |
| errors       | source                   | object   | References to the source of the error.                                          |
| source       | header                   | string   | A string indicating the name of a single request header which caused the error. |
| source       | parameter                | string   | A string indicating which URI query parameter caused the error.                 |
| source       | pointer                  | string   | A JSON pointer to the value in the request document that caused the error.      |
| errors       | status                   | string   | Status code of the response.                                                    |
| errors       | title                    | string   | Short human-readable summary of the error.                                      |

{% /tab %}

{% tab title="Example" %}

```json
{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}
```

{% /tab %}

{% /tab %}

{% tab title="401" %}
Missing or invalid authentication (dd-api-key + dd-application-key headers, or a valid user session).
{% tab title="Model" %}
API error response.

| Parent field | Field                    | Type     | Description                                                                     |
| ------------ | ------------------------ | -------- | ------------------------------------------------------------------------------- |
|              | errors [*required*] | [object] | A list of errors.                                                               |
| errors       | detail                   | string   | A human-readable explanation specific to this occurrence of the error.          |
| errors       | meta                     | object   | Non-standard meta-information about the error                                   |
| errors       | source                   | object   | References to the source of the error.                                          |
| source       | header                   | string   | A string indicating the name of a single request header which caused the error. |
| source       | parameter                | string   | A string indicating which URI query parameter caused the error.                 |
| source       | pointer                  | string   | A JSON pointer to the value in the request document that caused the error.      |
| errors       | status                   | string   | Status code of the response.                                                    |
| errors       | title                    | string   | Short human-readable summary of the error.                                      |

{% /tab %}

{% tab title="Example" %}

```json
{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}
```

{% /tab %}

{% /tab %}

{% tab title="403" %}
Authenticated caller lacks the product_analytics_experiments_read permission, or lacks feature-flag and environment read permissions for a Datadog-backed configuration.
{% tab title="Model" %}
API error response.

| Parent field | Field                    | Type     | Description                                                                     |
| ------------ | ------------------------ | -------- | ------------------------------------------------------------------------------- |
|              | errors [*required*] | [object] | A list of errors.                                                               |
| errors       | detail                   | string   | A human-readable explanation specific to this occurrence of the error.          |
| errors       | meta                     | object   | Non-standard meta-information about the error                                   |
| errors       | source                   | object   | References to the source of the error.                                          |
| source       | header                   | string   | A string indicating the name of a single request header which caused the error. |
| source       | parameter                | string   | A string indicating which URI query parameter caused the error.                 |
| source       | pointer                  | string   | A JSON pointer to the value in the request document that caused the error.      |
| errors       | status                   | string   | Status code of the response.                                                    |
| errors       | title                    | string   | Short human-readable summary of the error.                                      |

{% /tab %}

{% tab title="Example" %}

```json
{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}
```

{% /tab %}

{% /tab %}

{% tab title="404" %}
No experiment with this ID exists for the organization.
{% tab title="Model" %}
API error response.

| Parent field | Field                    | Type     | Description                                                                     |
| ------------ | ------------------------ | -------- | ------------------------------------------------------------------------------- |
|              | errors [*required*] | [object] | A list of errors.                                                               |
| errors       | detail                   | string   | A human-readable explanation specific to this occurrence of the error.          |
| errors       | meta                     | object   | Non-standard meta-information about the error                                   |
| errors       | source                   | object   | References to the source of the error.                                          |
| source       | header                   | string   | A string indicating the name of a single request header which caused the error. |
| source       | parameter                | string   | A string indicating which URI query parameter caused the error.                 |
| source       | pointer                  | string   | A JSON pointer to the value in the request document that caused the error.      |
| errors       | status                   | string   | Status code of the response.                                                    |
| errors       | title                    | string   | Short human-readable summary of the error.                                      |

{% /tab %}

{% tab title="Example" %}

```json
{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}
```

{% /tab %}

{% /tab %}

{% tab title="409" %}
The stored assignment configuration cannot be represented losslessly by this API (unsupported_configuration).
{% tab title="Model" %}
API error response.

| Parent field | Field                    | Type     | Description                                                                     |
| ------------ | ------------------------ | -------- | ------------------------------------------------------------------------------- |
|              | errors [*required*] | [object] | A list of errors.                                                               |
| errors       | detail                   | string   | A human-readable explanation specific to this occurrence of the error.          |
| errors       | meta                     | object   | Non-standard meta-information about the error                                   |
| errors       | source                   | object   | References to the source of the error.                                          |
| source       | header                   | string   | A string indicating the name of a single request header which caused the error. |
| source       | parameter                | string   | A string indicating which URI query parameter caused the error.                 |
| source       | pointer                  | string   | A JSON pointer to the value in the request document that caused the error.      |
| errors       | status                   | string   | Status code of the response.                                                    |
| errors       | title                    | string   | Short human-readable summary of the error.                                      |

{% /tab %}

{% tab title="Example" %}

```json
{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}
```

{% /tab %}

{% /tab %}

{% tab title="429" %}
Too many requests
{% tab title="Model" %}
API error response.

| Field                    | Type     | Description       |
| ------------------------ | -------- | ----------------- |
| errors [*required*] | [string] | A list of errors. |

{% /tab %}

{% tab title="Example" %}

```json
{
  "errors": [
    "Bad Request"
  ]
}
```

{% /tab %}

{% /tab %}

### Code Example

##### 
                  \# Path parameters export experiment_id="550e8400-e29b-41d4-a716-446655440000" \# Use a Personal Access Token or Service Access Token export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"  \# Curl command curl -X GET "https://api.datadoghq.com/api/v2/experiments/${experiment_id}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" 

                
##### 

```python
"""
Get experiment returns "OK" response
"""

from os import environ
from datadog_api_client import ApiClient, Configuration
from datadog_api_client.v2.api.experiments_api import ExperimentsApi

# there is a valid "experiment" in the system
EXPERIMENT_DATA_ID = environ["EXPERIMENT_DATA_ID"]

configuration = Configuration()
configuration.access_token = environ["DD_BEARER_TOKEN"]
with ApiClient(configuration) as api_client:
    api_instance = ExperimentsApi(api_client)
    response = api_instance.get_experiment(
        experiment_id=EXPERIMENT_DATA_ID,
    )

    print(response)
```

#### Instructions

First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=python) and then save the example to `example.py` and run following commands:
    DD_SITE="datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" python3 "example.py"
##### 

```ruby
# Get experiment returns "OK" response

require "datadog_api_client"
DatadogAPIClient.configure do |config|
  config.access_token = ENV["DD_BEARER_TOKEN"]
end
api_instance = DatadogAPIClient::V2::ExperimentsAPI.new

# there is a valid "experiment" in the system
EXPERIMENT_DATA_ID = ENV["EXPERIMENT_DATA_ID"]
p api_instance.get_experiment(EXPERIMENT_DATA_ID)
```

#### Instructions

First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=ruby) and then save the example to `example.rb` and run following commands:
    DD_SITE="datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" rb "example.rb"
##### 

```go
// Get experiment returns "OK" response

package main

import (
	"context"
	"encoding/json"
	"fmt"
	"os"

	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
	"github.com/DataDog/datadog-api-client-go/v2/api/datadogV2"
	"github.com/google/uuid"
)

func main() {
	// there is a valid "experiment" in the system
	ExperimentDataID := uuid.MustParse(os.Getenv("EXPERIMENT_DATA_ID"))

	ctx := datadog.NewDefaultContext(context.Background())
	ctx = context.WithValue(ctx, datadog.ContextAccessToken, os.Getenv("DD_BEARER_TOKEN"))
	configuration := datadog.NewConfiguration()
	apiClient := datadog.NewAPIClient(configuration)
	api := datadogV2.NewExperimentsApi(apiClient)
	resp, r, err := api.GetExperiment(ctx, ExperimentDataID)

	if err != nil {
		fmt.Fprintf(os.Stderr, "Error when calling `ExperimentsApi.GetExperiment`: %v\n", err)
		fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
	}

	responseContent, _ := json.MarshalIndent(resp, "", "  ")
	fmt.Fprintf(os.Stdout, "Response from `ExperimentsApi.GetExperiment`:\n%s\n", responseContent)
}
```

#### Instructions

First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=go) and then save the example to `main.go` and run following commands:
    DD_SITE="datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" go run "main.go"
##### 

```java
// Get experiment returns "OK" response

import com.datadog.api.client.ApiClient;
import com.datadog.api.client.ApiException;
import com.datadog.api.client.v2.api.ExperimentsApi;
import com.datadog.api.client.v2.model.ExperimentsExperimentV2DTO;
import java.util.UUID;

public class Example {
  public static void main(String[] args) {
    ApiClient defaultClient = ApiClient.getDefaultApiClient();
    defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN"));
    ExperimentsApi apiInstance = new ExperimentsApi(defaultClient);

    // there is a valid "experiment" in the system
    UUID EXPERIMENT_DATA_ID = null;
    try {
      EXPERIMENT_DATA_ID = UUID.fromString(System.getenv("EXPERIMENT_DATA_ID"));
    } catch (IllegalArgumentException e) {
      System.err.println("Error parsing UUID: " + e.getMessage());
    }

    try {
      ExperimentsExperimentV2DTO result = apiInstance.getExperiment(EXPERIMENT_DATA_ID);
      System.out.println(result);
    } catch (ApiException e) {
      System.err.println("Exception when calling ExperimentsApi#getExperiment");
      System.err.println("Status code: " + e.getCode());
      System.err.println("Reason: " + e.getResponseBody());
      System.err.println("Response headers: " + e.getResponseHeaders());
      e.printStackTrace();
    }
  }
}
```

#### Instructions

First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=java) and then save the example to `Example.java` and run following commands:
    DD_SITE="datadoghq.com" DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>" java "Example.java"
##### 

```rust
// Get experiment returns "OK" response
use datadog_api_client::datadog;
use datadog_api_client::datadogV2::api_experiments::ExperimentsAPI;

#[tokio::main]
async fn main() {
    // there is a valid "experiment" in the system
    let experiment_data_id =
        uuid::Uuid::parse_str(&std::env::var("EXPERIMENT_DATA_ID").unwrap()).expect("Invalid UUID");
    let configuration = datadog::Configuration::new();
    let api = ExperimentsAPI::with_config(configuration);
    let resp = api.get_experiment(experiment_data_id.clone()).await;
    if let Ok(value) = resp {
        println!("{:#?}", value);
    } else {
        println!("{:#?}", resp.unwrap_err());
    }
}
```

#### Instructions

First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=rust) and then save the example to `src/main.rs` and run following commands:
    DD_SITE="datadoghq.com" DD_API_KEY="<DD_API_KEY>" DD_APP_KEY="<DD_APP_KEY>" cargo run
{% /tab %}
