Experiments

Get bandit traffic summary

Changed on

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.

get/api/v2/experiments/bandits/{bandit_id}/traffic-summary

Request

  • Base URL
    https://api.datadoghq.com
  • Auth
    • API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
    • or OAuth 2
      Authorization code/oauth2/v1/authorize
      Token URL/oauth2/v1/token
      Scopesproduct_analytics_experiments_read

Path parameters

bandit_idstring uuid required

The UUID of the bandit.

Example:4b1f3c2e-8d5a-4f6b-9c7e-1a2b3c4d5e6f

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

OK

Example response

{
  "data": {
    "attributes": {
      "daily": [
        {
          "cumulative_new_subjects": 3600,
          "cumulative_observations": 4260,
          "date": "2026-10-29",
          "feature_flag_variant_id": "770e8400-e29b-41d4-a716-446655440001",
          "new_subjects": 300,
          "observations": 410,
          "variant_key": "blue"
        }
      ],
      "data_as_of": "2026-10-30T00:00:00Z",
      "observation_counts": {
        "invalid": 40,
        "total": 14210,
        "valid_immature": 420,
        "valid_mature": 13750
      },
      "refresh_id": "bb0e8400-e29b-41d4-a716-446655440000",
      "total_subjects": 11900,
      "variants": [
        {
          "feature_flag_variant_id": "770e8400-e29b-41d4-a716-446655440001",
          "observations": 4260,
          "subjects": 3600,
          "variant_key": "blue"
        }
      ]
    },
    "id": "4b1f3c2e-8d5a-4f6b-9c7e-1a2b3c4d5e6f",
    "type": "bandit-traffic-summary"
  }
}

Changes