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

# Get bandit traffic summary

`GET /api/v2/experiments/bandits/{bandit_id}/traffic-summary`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/experiments/bandits/{bandit_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`

Get what a bandit has observed, as of its latest saved refresh: observation counts, subjects, and each arm's valid observations and subjects in total and per UTC day. An observation is a subject's reward on the arm it was exposed to, counted on the UTC day of its anchor time. `filter[from]` and `filter[to]` narrow only `daily`, not the totals. Bandits must be enabled for the organization.

## Path parameters

- `bandit_id` string, uuid, required: The UUID of the bandit.

## Query parameters

- `filter[from]` string, date-time: Return only the UTC days that overlap the range starting at this RFC3339 timestamp. Inclusive.
- `filter[to]` string, date-time: Return only the UTC days that overlap the range ending at this RFC3339 timestamp. Exclusive.

## Response `200`

OK

- ExperimentsBanditTrafficSummaryV2DTO: Response containing a bandit's traffic summary.
  - `data` ExperimentsBanditTrafficSummaryV2DTOData, required: JSON:API resource containing a bandit's traffic summary.
    - `attributes` ExperimentsBanditTrafficSummaryV2DTODataAttributes, required: What the bandit has observed, as of its latest saved refresh.
      - `daily` ExperimentsBanditDailyTrafficV2[], required: Valid observations per arm, grouped by the UTC day of their anchor time. Includes each day from the bandit's start to the data cutoff that overlaps the requested range. Days without observations have zero counts. Empty before the first saved refresh.
        - `cumulative_new_subjects` integer, required: The arm's new subjects from the bandit's start through this day, including days before the requested range.
        - `cumulative_observations` integer, required: The arm's observations from the bandit's start through this day, including days before the requested range.
        - `date` string, date, required: A UTC date as YYYY-MM-DD.
        - `feature_flag_variant_id` string, uuid, required: The arm's variant ID on the flag.
        - `new_subjects` integer, required: Subjects whose first valid observation is on this day and arm.
        - `observations` integer, required: The arm's valid observations on this day.
        - `variant_key` string, nullable, required: The arm's variant key.
      - `data_as_of` string, date-time, nullable, required: The timestamp of the most recent warehouse data that the latest saved refresh read.
      - `observation_counts` ExperimentsBanditObservationCountsV2, nullable, required: How many observations the latest saved refresh saw, regardless of the requested range. `null` when its counts can't be read.
        - `invalid` integer, required: Observations the refresh couldn't use.
        - `total` integer, required: All observations (the sum of the other three counts).
        - `valid_immature` integer, required: Valid observations whose aggregation window is still open.
        - `valid_mature` integer, required: Valid observations whose aggregation window has closed. The estimates use these.
      - `refresh_id` string, uuid, nullable, required: The latest refresh that saved results. The counts come from it.
      - `total_subjects` integer, required: Distinct subjects with a valid observation, regardless of the requested range.
      - `variants` ExperimentsBanditTrafficVariantV2[], required: One row per arm, regardless of the requested range.
        - `feature_flag_variant_id` string, uuid, required: The arm's variant ID on the flag.
        - `observations` integer, required: The arm's valid observations, regardless of whether their aggregation windows have closed.
        - `subjects` integer, required: Subjects whose first valid observation is on this arm. A subject counts once, on the arm its reward goes to.
        - `variant_key` string, nullable, required: The arm's variant key.
    - `id` string, uuid, required: The bandit ID.
    - `type` 'bandit-traffic-summary', required: Bandit traffic summary resource type.

## Other responses

- `400`: Malformed bandit ID (not a valid UUID), or filter[from] or filter[to] isn't an RFC3339 timestamp, or filter[from] isn't before filter[to].
- `401`: Missing or invalid authentication (dd-api-key + dd-application-key headers, or a valid user session).
- `403`: Bandits are not enabled for the organization, or the caller lacks the product_analytics_experiments_read permission.
- `404`: No bandit with this ID exists for the organization.
- `429`: Too many requests

## Changes

- **2026-11-17** `633e476d0d57`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/changes/api/v2/experiments/bandits/:bandit_id/traffic-summary/get.md)

---

[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/8d1a5e5973da?raw)
