---
title: "Get Experiment"
method: GET
path: "/v2/projects/{project_id}/experiments/{experiment_id}"
tags: ["experiment"]
---

# Get Experiment

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

Retrieve a specific experiment.

## Path parameters

- `experiment_id` string, uuid4, required
- `project_id` string, uuid4, required

## 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` 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.net/galileo/apis/galileo-api-server.md) · [All operations](https://skmtc.net/galileo/apis/galileo-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/galileo/galileo-api-server/versions/933e8c8e6366/schema)