--- title: Get metric 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 metric{% #get-metric %} {% tab title="v2" %} | Datadog site | API endpoint | | ----------------- | ------------------------------------------------------------------------ | | ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/experiments/metrics/{metric_id} | | ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/experiments/metrics/{metric_id} | | app.datadoghq.eu | GET https://api.datadoghq.eu/api/v2/experiments/metrics/{metric_id} | | app.ddog-gov.com | GET https://api.ddog-gov.com/api/v2/experiments/metrics/{metric_id} | | us2.ddog-gov.com | GET https://api.us2.ddog-gov.com/api/v2/experiments/metrics/{metric_id} | | uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/experiments/metrics/{metric_id} | | app.datadoghq.com | GET https://api.datadoghq.com/api/v2/experiments/metrics/{metric_id} | | us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/experiments/metrics/{metric_id} | | us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/experiments/metrics/{metric_id} | ### Overview Get a metric. Returns a single experiment metric by its ID for the organization. This endpoint requires the `product_analytics_metrics_read` permission. OAuth apps require the `product_analytics_metrics_read` authorization [scope](https://docs.datadoghq.com/api/latest/scopes.md#experiments) to access this endpoint. ### Arguments #### Path Parameters | Name | Type | Description | | --------------------------- | ------ | ----------------------- | | metric_id [*required*] | string | The UUID of the metric. | #### Query Strings | Name | Type | Description | | ------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | include | array | Optional fields to include. Repeat this parameter to request several fields. `counts` adds experiment_count: how many experiments currently reference this metric. | ### Response {% tab title="200" %} OK {% tab title="Model" %} Response containing the metric. | Parent field | Field | Type | Description | | ------------------------ | ----------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | | data [*required*] | object | JSON:API resource containing the metric identity and fields. | | data | attributes | object | Details of the metric. | | attributes | certified_at | date-time | Time when this resource was certified. | | attributes | created_at | date-time | Time when this resource was created. | | attributes | data_source_type | enum | Source of the data used to calculate the metric. Allowed enum values: `DATADOG,DATADOG_REFERENCE_TABLE,CUSTOMER_WAREHOUSE,IMPORTED,UNKNOWN` | | attributes | denominator_aggregation | object | Source measure and aggregation settings for a metric value. | | denominator_aggregation | aging_threshold_days | int64 | Stored aging threshold in days. The subject aging filter uses the aggregation window end and unit. | | denominator_aggregation | datadog_metric_measure | object | Datadog source and query that supply values for the metric. | | datadog_metric_measure | column_name | string | Name of the Datadog event field used by this measure. | | datadog_metric_measure | column_type | string | Data type of the source column. | | datadog_metric_measure | filters | | Conditions used to select the metric's source data. | | datadog_metric_measure | name | string | Display name of the Datadog measure. | | datadog_metric_measure | query | string | Query used to retrieve the Datadog measure. | | datadog_metric_measure | source_definition_filter | | Filter applied to the Datadog source definition. | | datadog_metric_measure | source_subtype | string | Subtype of the Datadog data source. | | datadog_metric_measure | source_type | string | Type of Datadog data source used for the measure. | | denominator_aggregation | enable_aging_subject_filter | boolean | Whether to exclude subjects whose observation time is shorter than the aggregation window. | | denominator_aggregation | operation | string | Aggregation applied to the selected measure. | | denominator_aggregation | pipeline_column_suffix | string | Suffix used to identify this value in pipeline output columns. | | denominator_aggregation | property_filters | [array] | Filters applied to the metric aggregation. | | denominator_aggregation | threshold_aggregation_type | string | Aggregation used to evaluate the threshold. | | denominator_aggregation | threshold_breach_value | double | Value used to determine whether the threshold is breached. | | denominator_aggregation | threshold_comparison_operator | string | Comparison applied between the aggregated value and the threshold. | | denominator_aggregation | threshold_timeframe_dimension | string | Time unit used for the threshold evaluation window. | | denominator_aggregation | threshold_timeframe_value | double | Size of the threshold evaluation window. | | denominator_aggregation | timeframe_end_value | double | End of the aggregation window in the specified time unit. | | denominator_aggregation | timeframe_start_value | double | Start of the aggregation window in the specified time unit. | | denominator_aggregation | timeframe_unit | string | Time unit used for the aggregation window. | | denominator_aggregation | warehouse_metric_measure | object | Warehouse measure that supplies values for the metric. | | warehouse_metric_measure | id | string | ID of the measure. | | warehouse_metric_measure | pipeline_column_suffix | string | Suffix used to identify this value in pipeline output columns. | | denominator_aggregation | winsor_lower_fixed_value | double | Fixed lower bound used to cap metric values. | | denominator_aggregation | winsor_lower_percentile | double | Percentile used to determine the lower bound for capped metric values. | | denominator_aggregation | winsor_upper_fixed_value | double | Fixed upper bound used to cap metric values. | | denominator_aggregation | winsor_upper_percentile | double | Percentile used to determine the upper bound for capped metric values. | | denominator_aggregation | winsorization_strategy | string | Method used to cap extreme metric values. | | attributes | description | string | Text that explains the metric. | | attributes | desired_change | enum | Direction of metric change considered desirable. Allowed enum values: `METRIC_INCREASES,METRIC_DECREASES,UNKNOWN` | | attributes | experiment_count | int64 | Number of experiments that reference this resource. | | attributes | format_as_percent | boolean | Whether to display the metric value as a percentage. | | attributes | guardrail_cutoff_threshold | double | Threshold used when evaluating this metric as a guardrail. | | attributes | metric_type | enum | Type of metric calculation. Allowed enum values: `SIMPLE,RATIO,PERCENTILE,UNKNOWN` | | attributes | migration_metadata | | Metadata retained for resources imported from another system. | | attributes | name | string | Display name of the metric. | | attributes | numerator_aggregation | object | Source measure and aggregation settings for a metric value. | | numerator_aggregation | aging_threshold_days | int64 | Stored aging threshold in days. The subject aging filter uses the aggregation window end and unit. | | numerator_aggregation | datadog_metric_measure | object | Datadog source and query that supply values for the metric. | | datadog_metric_measure | column_name | string | Name of the Datadog event field used by this measure. | | datadog_metric_measure | column_type | string | Data type of the source column. | | datadog_metric_measure | filters | | Conditions used to select the metric's source data. | | datadog_metric_measure | name | string | Display name of the Datadog measure. | | datadog_metric_measure | query | string | Query used to retrieve the Datadog measure. | | datadog_metric_measure | source_definition_filter | | Filter applied to the Datadog source definition. | | datadog_metric_measure | source_subtype | string | Subtype of the Datadog data source. | | datadog_metric_measure | source_type | string | Type of Datadog data source used for the measure. | | numerator_aggregation | enable_aging_subject_filter | boolean | Whether to exclude subjects whose observation time is shorter than the aggregation window. | | numerator_aggregation | operation | string | Aggregation applied to the selected measure. | | numerator_aggregation | pipeline_column_suffix | string | Suffix used to identify this value in pipeline output columns. | | numerator_aggregation | property_filters | [array] | Filters applied to the metric aggregation. | | numerator_aggregation | threshold_aggregation_type | string | Aggregation used to evaluate the threshold. | | numerator_aggregation | threshold_breach_value | double | Value used to determine whether the threshold is breached. | | numerator_aggregation | threshold_comparison_operator | string | Comparison applied between the aggregated value and the threshold. | | numerator_aggregation | threshold_timeframe_dimension | string | Time unit used for the threshold evaluation window. | | numerator_aggregation | threshold_timeframe_value | double | Size of the threshold evaluation window. | | numerator_aggregation | timeframe_end_value | double | End of the aggregation window in the specified time unit. | | numerator_aggregation | timeframe_start_value | double | Start of the aggregation window in the specified time unit. | | numerator_aggregation | timeframe_unit | string | Time unit used for the aggregation window. | | numerator_aggregation | warehouse_metric_measure | object | Warehouse measure that supplies values for the metric. | | warehouse_metric_measure | id | string | ID of the measure. | | warehouse_metric_measure | pipeline_column_suffix | string | Suffix used to identify this value in pipeline output columns. | | numerator_aggregation | winsor_lower_fixed_value | double | Fixed lower bound used to cap metric values. | | numerator_aggregation | winsor_lower_percentile | double | Percentile used to determine the lower bound for capped metric values. | | numerator_aggregation | winsor_upper_fixed_value | double | Fixed upper bound used to cap metric values. | | numerator_aggregation | winsor_upper_percentile | double | Percentile used to determine the upper bound for capped metric values. | | numerator_aggregation | winsorization_strategy | string | Method used to cap extreme metric values. | | attributes | percentile_aggregation | object | Source measure and settings for a percentile metric. | | percentile_aggregation | datadog_metric_measure | object | Datadog source and query that supply values for the metric. | | datadog_metric_measure | column_name | string | Name of the Datadog event field used by this measure. | | datadog_metric_measure | column_type | string | Data type of the source column. | | datadog_metric_measure | filters | | Conditions used to select the metric's source data. | | datadog_metric_measure | name | string | Display name of the Datadog measure. | | datadog_metric_measure | query | string | Query used to retrieve the Datadog measure. | | datadog_metric_measure | source_definition_filter | | Filter applied to the Datadog source definition. | | datadog_metric_measure | source_subtype | string | Subtype of the Datadog data source. | | datadog_metric_measure | source_type | string | Type of Datadog data source used for the measure. | | percentile_aggregation | percentile | double | Percentile calculated from the selected measure. | | percentile_aggregation | pipeline_column_suffix | string | Suffix used to identify this value in pipeline output columns. | | percentile_aggregation | property_filters | [array] | Filters applied to the metric aggregation. | | percentile_aggregation | warehouse_metric_measure | object | Warehouse measure that supplies values for the metric. | | warehouse_metric_measure | id | string | ID of the measure. | | warehouse_metric_measure | pipeline_column_suffix | string | Suffix used to identify this value in pipeline output columns. | | attributes | reference_url | string | URL with supporting information about the metric. | | attributes | updated_at | date-time | Time when this resource was last updated. | | data | id [*required*] | uuid | ID of the metric. | | data | type [*required*] | enum | The metric resource type. Allowed enum values: `metrics` | {% /tab %} {% tab title="Example" %} ```json { "data": { "attributes": { "created_at": "2024-01-01T12:00:00Z", "data_source_type": "CUSTOMER_WAREHOUSE", "description": "Share of sessions that reach the order confirmation page", "desired_change": "METRIC_INCREASES", "format_as_percent": true, "metric_type": "SIMPLE", "name": "Checkout conversion", "numerator_aggregation": { "operation": "sum", "pipeline_column_suffix": "agg001", "timeframe_start_value": 0, "warehouse_metric_measure": { "id": "550e8400-e29b-41d4-a716-446655440021", "pipeline_column_suffix": "rev001" } }, "reference_url": "", "updated_at": "2024-01-01T12:00:00Z" }, "id": "550e8400-e29b-41d4-a716-446655440002", "type": "metrics" } } ``` {% /tab %} {% /tab %} {% tab title="400" %} Malformed metric 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. {% 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_metrics_read permission. {% 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 metric 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="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 metric_id="550e8400-e29b-41d4-a716-446655440000" \# Use a Personal Access Token or Service Access Token export DD_BEARER_TOKEN="" \# Curl command curl -X GET "https://api.datadoghq.com/api/v2/experiments/metrics/${metric_id}" \ -H "Accept: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}" {% /tab %}