List bandits
Changed onList 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.
Request
- Base URLhttps://api.datadoghq.com
- Auth
- API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
- or OAuth 2Authorization code/oauth2/v1/authorizeToken URL/oauth2/v1/tokenScopesproduct_analytics_experiments_read
Query parameters
Number of results to skip for pagination. Defaults to 0 when omitted.
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.
Find bandits whose names contain the search text, regardless of case.
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 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 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 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
- info
endpoint added
- info