DAdatadog
Experiments

List experiments

List experiments. Returns a paginated list of experiments and their structured metadata for the organization. Supports filtering and pagination. Use Get experiment for variants, decision metrics, traffic exposure, and assignment configuration.

get/api/v2/experiments

Request

Query parameters

concluded_sincestring date-time

Return only experiments concluded at or after this RFC3339 timestamp. Inclusive, and excludes experiments that have not concluded.

Return only experiments concluded at or after this RFC3339 timestamp. Inclusive, and excludes experiments that have not concluded.

created_sincestring date-time

Return only experiments created at or after this RFC3339 timestamp. Inclusive.

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.

page[offset]integer

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

protocol_idstring[]

Filter by protocol UUID. Repeat this parameter to supply several IDs. An experiment matches if it uses any listed protocol.

Filter by protocol UUID. Repeat this parameter to supply several IDs. An experiment matches if it uses any listed protocol.

results_updated_beforestring date-time

Return only experiments whose results_last_updated is before this RFC3339 timestamp. results_last_updated is the later of the latest successful run completion and the latest stored result refresh. Exclusive, and excludes experiments without successful results.

Return only experiments whose results_last_updated is before this RFC3339 timestamp. results_last_updated is the later of the latest successful run completion and the latest stored result refresh. Exclusive, and excludes experiments without successful results.

results_updated_sincestring date-time

Return only experiments whose results_last_updated is at or after this RFC3339 timestamp. results_last_updated is the later of the latest successful run completion and the latest stored result refresh. Inclusive, and excludes experiments without successful results. This filter does not include all metadata edits or deletions.

searchstring

Find experiments 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.

statusstring[]

Filter by experiment status. Accepted values are DRAFT, SCHEDULED, IN_PROGRESS, READY_FOR_DECISION, DECISION_MADE, and CANCELLED. Repeat this parameter to select several statuses, for example status=IN_PROGRESS&status=READY_FOR_DECISION.

tagsstring[]

Filter by tag name. Repeat this parameter to supply several tags. An experiment matches if it has at least one listed tag.

Filter by tag name. Repeat this parameter to supply several tags. An experiment matches if it has at least one listed tag.

Response

OK

Example response

{
  "data": [
    {
      "attributes": {
        "assignments_end_date": "2026-08-15T00:00:00Z",
        "assignments_start_date": "2026-08-01T00:00:00Z",
        "concluded_at": "2026-08-05T09:30:00Z",
        "conclusion": {
          "decision_reason": "The primary metric improved without material regressions",
          "outcome": "POSITIVE",
          "summary": "The treatment improved conversion"
        },
        "created_at": "2026-08-01T12:00:00Z",
        "events_end_date": "2026-08-22T00:00:00Z",
        "events_start_date": "2026-08-01T00:00:00Z",
        "experiment_type": "STANDARD",
        "hypothesis": "A clearer checkout button increases purchase conversion",
        "name": "Checkout button test",
        "pipeline_table_suffix": "a1b2c3d4",
        "protocol_id": "e4d5f6a7-0000-0000-0000-000000000000",
        "related_links": [
          {
            "id": "d1d2d3d4-0000-0000-0000-000000000000",
            "title": "Experiment design",
            "url": "https://docs.example.com/checkout-experiment"
          }
        ],
        "results_last_updated": "2026-08-05T09:25:00Z",
        "status": "DECISION_MADE",
        "structured_metadata": [
          {
            "enum_values": [
              "beta"
            ],
            "field_display_name": "Launch stage",
            "field_key": "launch_stage",
            "field_type": "ENUM"
          },
          {
            "field_display_name": "Notes",
            "field_key": "notes",
            "field_type": "FREETEXT",
            "freetext_value": "Checkout redesign"
          }
        ],
        "subject_type_id": "c2b3d4e5-0000-0000-0000-000000000000",
        "summary": "The treatment improved conversion",
        "tags": [
          "growth"
        ],
        "teams": [
          "growth"
        ],
        "updated_at": "2026-08-05T09:30:00Z"
      },
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "experiments"
    }
  ]
}

Changes

Changes to this operation have not been checked yet.