Experiments

List the organization's bandits, newest first by default. Each item is a summary. For a bandit's setup, active policy, and latest refresh, use Get bandit. Bandits must be enabled for the organization.

get/api/v2/experiments/bandits

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

Query parameters

page[offset]integer

Number of results to skip for pagination. Defaults to 0 when omitted.

page[limit]integer

Maximum number of results to return. Defaults to 25 when omitted, and is capped at 50 (larger values are clamped to 50). The response includes meta.page (with total) and pagination links.

Maximum number of results to return. Defaults to 25 when omitted, and is capped at 50 (larger values are clamped to 50). The response includes meta.page (with total) and pagination links.

filter[query]string

Find bandits whose names contain the search text, regardless of case.

sortstring

Sort fields: name, created_at, or updated_at. Use a comma-separated list in priority order; for example, name,-created_at. Prefix each field with - for descending. Defaults to created_at descending.

Sort fields: name, created_at, or updated_at. Use a comma-separated list in priority order; for example, name,-created_at. Prefix each field with - for descending. Defaults to created_at descending.

filter[status]string[]

Filter by bandit status. Accepted values are DRAFT, SCHEDULED, RUNNING, PAUSED, STOPPED, and COMPLETED. Repeat this parameter to select several statuses; for example, filter[status]=RUNNING&filter[status]=PAUSED.

filter[subject_type_id]string[]

Filter by subject type UUID. Repeat this parameter to supply several IDs. A bandit matches if it uses any listed subject type.

Filter by subject type UUID. Repeat this parameter to supply several IDs. A bandit matches if it uses any listed subject type.

filter[tags]string[]

Filter by tag name. Repeat this parameter to supply several tags. A bandit matches if it has at least one listed tag. Use team:<handle> to filter by team. When both tags and teams are given, a bandit must match one of each.

Filter by tag name. Repeat this parameter to supply several tags. A bandit matches if it has at least one listed tag. Use team:<handle> to filter by team. When both tags and teams are given, a bandit must match one of each.

Response

OK

Example response

{
  "data": [
    {
      "attributes": {
        "created_at": "2026-10-22T12:00:00Z",
        "description": "Find the button color that maximizes checkout revenue.",
        "ended_at": "2026-12-01T00:00:00Z",
        "metric_id": "990e8400-e29b-41d4-a716-446655440000",
        "name": "Checkout button color",
        "optimal_variant_key": "green",
        "optimal_variant_unavailable_reason": "NOT_ENOUGH_DATA",
        "started_at": "2026-10-23T09:00:00Z",
        "status": "RUNNING",
        "subject_type_id": "880e8400-e29b-41d4-a716-446655440000",
        "tags": [
          "checkout"
        ],
        "teams": [
          "growth"
        ],
        "updated_at": "2026-10-30T02:15:00Z"
      },
      "id": "4b1f3c2e-8d5a-4f6b-9c7e-1a2b3c4d5e6f",
      "type": "bandits"
    }
  ]
}

Changes