---
title: "List experiment metric groups"
method: GET
path: "/api/v2/experiments/{experiment_id}/metric-groups"
tags: ["Experiments"]
---

# List experiment metric groups

`GET /api/v2/experiments/{experiment_id}/metric-groups`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/experiments/{experiment_id}/metric-groups`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `product_analytics_experiments_read`
- TypeScript: <https://skmtc.dev/datadog/apis/datadog-api-v2-collection/docs/api/v2/experiments/:experiment_id/metric-groups/get.ts> (a function with typed inputs; its response is checked against the schema)

List every decision and non-decision metric group attached to an experiment. Metric references are returned in their stored order. An incomplete draft can have no decision group and returns only the groups that exist.

## Path parameters

- `experiment_id` string, uuid, required: The UUID of the experiment.

## Response `200`

OK

- ExperimentsExperimentMetricGroupV2DTOArray: Response containing the metric groups for an experiment.
  - `data` ExperimentsExperimentMetricGroupMutationV2Data[], required: Metric groups associated with the experiment.
    - `attributes` ExperimentsExperimentMetricGroupV2DTODataAttributes: Name, purpose, and selected metrics of an experiment metric group.
      - `is_decision` boolean: Whether this group contains the experiment decision metrics.
      - `metrics` ExperimentsExperimentMetricGroupMutationV2DataAttributesMetricsItems[]: Metrics selected for this experiment metric group.
        - `is_primary` boolean, required: Whether this is the experiment primary metric.
        - `metric_id` string, required: Identifier of the metric in the group.
        - `metric_name` string, required: Display name of the metric in the group.
      - `migration_metadata` unknown
      - `name` string: Display name of the experiment metric group.
    - `id` string, uuid, required: Identifier of the experiment metric group.
    - `type` 'experiment-metric-groups', required: Experiment metric groups resource type.

## Other responses

- `400`: Malformed experiment ID.
- `401`: Missing or invalid authentication.
- `403`: The caller lacks the experiments read permission.
- `404`: No experiment with this ID exists for the organization.
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/3f70db624329?raw)