---
title: "Get experiment traffic summary"
method: GET
path: "/api/v2/experiments/{experiment_id}/traffic-summary"
tags: ["Experiments"]
---

# Get experiment traffic summary

`GET /api/v2/experiments/{experiment_id}/traffic-summary`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/experiments/{experiment_id}/traffic-summary`
- 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/traffic-summary/get.ts> (a function with typed inputs; its response is checked against the schema)

Get an experiment's traffic summary: per-variant exposure counts and a sample-ratio-mismatch flag (is_traffic_imbalanced). SRM statistics live on the diagnostics endpoint.

## Path parameters

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

## Response `200`

OK

- ExperimentsTrafficSummaryV2DTO: Response containing the experiment traffic summary.
  - `data` ExperimentsTrafficSummaryV2DTOData, required: JSON:API resource containing the experiment traffic summary identity and fields.
    - `attributes` ExperimentsTrafficSummaryV2DTODataAttributes: Details of the experiment traffic summary.
      - `is_traffic_imbalanced` boolean: Whether the observed variant traffic is imbalanced.
      - `total_subjects` integer: Total number of subjects included in the traffic summary.
      - `variants` ExperimentsTrafficSummaryV2DTODataAttributesVariantsItems[]: Exposure counts for each experiment variant.
        - `exposure_count` integer: Number of recorded exposures for this variant.
        - `variant_key` string: Key that identifies the experiment variant.
        - `variant_name` string: Display name of the experiment variant.
    - `id` string, required: Identifier of this traffic summary.
    - `type` 'traffic-summary', required: Traffic summary resource type.

## Other responses

- `400`: Malformed experiment ID (not a valid UUID), or the experiment is not configured for analysis.
- `401`: Missing or invalid authentication.
- `403`: Authenticated caller lacks the product_analytics_experiments_read permission.
- `404`: No experiment with this ID exists for the organization.
- `409`: The experiment's metrics are incompatible with analysis.
- `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)