---
title: "List Experiments"
method: GET
path: "/v2/projects/{project_id}/experiments"
tags: ["experiment"]
deprecated: true
---

# List Experiments

`GET /v2/projects/{project_id}/experiments`

## Request

- Base URL: `https://api.galileo.ai`
- URL: `https://api.galileo.ai/v2/projects/{project_id}/experiments`
- Auth: one of:
  - API key in header `Galileo-API-Key`
  - API key in header `Splunk-AO-API-Key`
  - OAuth 2
    - Password
    - Token URL: `https://api.galileo.ai/login`
  - HTTP basic

> **Deprecated.**

Retrieve all experiments for a project.

## Path parameters

- `project_id` string, uuid4, required

## Query parameters

- `include_counts` boolean

## Response `200`

Successful Response

- ExperimentResponse[]
  - `id` string, uuid4, required: Galileo ID of the experiment
  - `created_at` string, date-time: Timestamp of the experiment's creation
  - `updated_at` string, date-time, nullable: Timestamp of the trace or span's last update
  - `name` string: Name of the experiment
  - `project_id` string, uuid4, required: Galileo ID of the project associated with this experiment
  - `created_by` string, uuid4, nullable
  - `created_by_user` UserInfo: A user's basic information, used for display purposes.
    - `id` string, uuid4, required
    - `email` string, required
    - `first_name` string, nullable
    - `last_name` string, nullable
  - `num_spans` integer, nullable
  - `num_traces` integer, nullable
  - `num_sessions` integer, nullable
  - `task_type` 7 | 9 | 12 | 13 | 15 | 16 | 17 | 18, required: Valid task types for modeling. We store these as ints instead of strings because we will be looking this up in the database frequently.
  - `dataset` ExperimentDataset
    - `dataset_id` string, uuid4, nullable
    - `version_index` integer, nullable
    - `name` string, nullable
  - `aggregate_metrics` object
  - `structured_aggregate_metrics` object, nullable: Structured aggregate metrics with full statistical aggregates (avg, min, max, sum, count). Keys are scorer UUIDs for scorer-backed metrics (matching available_columns column IDs after stripping the 'metrics/' prefix) and raw strings for system metrics (e.g. 'duration_ns', 'cost'). Present only when use_clickhouse_run_aggregates flag is enabled.
  - `aggregate_feedback` object: Aggregate feedback information related to the experiment (traces only)
  - `rating_aggregates` object: Annotation aggregates keyed by template ID and root type
  - `ranking_score` number, nullable
  - `rank` integer, nullable
  - `winner` boolean, nullable
  - `playground_id` string, uuid4, nullable
  - `playground` ExperimentPlayground
    - `playground_id` string, uuid4, nullable
    - `name` string, nullable
  - `prompt_run_settings` PromptRunSettingsOutput: Prompt run settings.
    - `logprobs` boolean
    - `top_logprobs` integer
    - `echo` boolean
    - `n` integer
    - `reasoning_effort` string
    - `verbosity` string
    - `deployment_name` string, nullable
    - `model_alias` string
    - `temperature` number, nullable
    - `max_tokens` integer
    - `stop_sequences` string[], nullable
    - `top_p` number
    - `top_k` integer
    - `frequency_penalty` number
    - `presence_penalty` number
    - `tools` string
    - `tool_choice` union
      - string
      - OpenAIToolChoice
        - `type` string
        - `function` OpenAIFunction, required
          - `name` string, required
    - `response_format` object, nullable
  - `prompt_model` string, nullable
  - `prompt` ExperimentPrompt
    - `prompt_template_id` string, uuid4, nullable
    - `version_index` integer, nullable
    - `name` string, nullable
    - `content` string, nullable
  - `tags` object
  - `status` ExperimentStatus
    - `log_generation` ExperimentPhaseStatus
      - `progress_percent` number: Progress percentage from 0.0 to 1.0
  - `experiment_group_id` string, uuid4, nullable
  - `experiment_group_name` string, nullable
  - `experiment_group_is_system` boolean, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/galileo/apis/galileo-api.md) - [All operations](https://skmtc.dev/galileo/apis/galileo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/galileo/apis/galileo-api/revisions/441b96da8c30?raw)