Experiments
Get bandit traffic summary
Changed onGet 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 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
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
- info
endpoint added
- info