Experiments

Get bandit results

Changed on

Get what a bandit's refreshes have learned: each arm's estimate and probability of being best from the latest saved refresh, and each arm's point estimate over time. filter[from] and filter[to] narrow only point_estimates, not the latest estimates. For observation counts, use Get bandit traffic summary. Bandits must be enabled for the organization.

get/api/v2/experiments/bandits/{bandit_id}/results

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 point estimates from refreshes saved at or after this RFC3339 timestamp. Inclusive.

filter[to]string date-time

Return only point estimates from refreshes saved before this RFC3339 timestamp. Exclusive.

Response

OK

Example response

{
  "data": {
    "attributes": {
      "confidence_level": 0.95,
      "config_version": 2,
      "data_as_of": "2026-10-30T00:00:00Z",
      "desired_change": "METRIC_INCREASES",
      "next_refresh_at": "2026-10-31T02:00:00Z",
      "optimal_variant_key": "green",
      "optimal_variant_unavailable_reason": "NOT_ENOUGH_DATA",
      "point_estimates": [
        {
          "confidence_interval": {
            "lower": 39.9,
            "upper": 42.5
          },
          "data_as_of": "2026-10-30T00:00:00Z",
          "feature_flag_variant_id": "770e8400-e29b-41d4-a716-446655440001",
          "point_estimate": 41.2,
          "refresh_id": "bb0e8400-e29b-41d4-a716-446655440000",
          "results_last_updated": "2026-10-30T02:15:00Z",
          "variant_key": "blue"
        }
      ],
      "refresh_id": "bb0e8400-e29b-41d4-a716-446655440000",
      "results_last_updated": "2026-10-30T02:15:00Z",
      "state": "OPTIMIZING",
      "statistics_status": "calculated",
      "variants": [
        {
          "confidence_interval": {
            "lower": 39.9,
            "upper": 42.5
          },
          "data_status": "usable",
          "feature_flag_variant_id": "770e8400-e29b-41d4-a716-446655440001",
          "mature_observations": 4120,
          "point_estimate": 41.2,
          "posterior_unavailable_reason": "no_data",
          "probability_of_being_optimal": 0.08,
          "variant_key": "blue"
        }
      ]
    },
    "id": "4b1f3c2e-8d5a-4f6b-9c7e-1a2b3c4d5e6f",
    "type": "bandit-results"
  }
}

Changes