---
title: "Search Experiments"
method: POST
path: "/v2/projects/{project_id}/experiments/search"
tags: ["experiment"]
---

# Search Experiments

`POST /v2/projects/{project_id}/experiments/search`

Search experiments for a project.

## Path parameters

- `project_id` string, uuid4, required

## Request body

- ExperimentSearchRequest
  - `starting_token` integer
  - `limit` integer
  - `filters` union[]
    - union
      - ExperimentIDFilter
        - `name` 'id'
        - `operator` 'eq' | 'ne' | 'one_of' | 'not_in' | 'contains'
        - `value` union, required
          - string, uuid4
          - union[]
            - union
              - …
          - string
      - ExperimentNameFilter
        - `name` 'name'
        - `operator` 'eq' | 'ne' | 'contains' | 'one_of' | 'not_in', required
        - `value` union, required
          - string
          - string[]
        - `case_sensitive` boolean
      - ExperimentCreatedByFilter
        - `name` 'created_by'
        - `operator` 'eq' | 'ne' | 'one_of' | 'not_in' | 'contains'
        - `value` union, required
          - string, uuid4
          - union[]
            - union
              - …
          - string
      - ExperimentCreatedAtFilter
        - `name` 'created_at'
        - `operator` 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte', required
        - `value` string, date-time, required
      - ExperimentUpdatedAtFilter
        - `name` 'updated_at'
        - `operator` 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte', required
        - `value` string, date-time, required
      - ApiSchemasExperimentExperimentGroupIDFilter
        - `name` 'experiment_group_id'
        - `value` string, uuid4, required
      - ApiSchemasExperimentExperimentGroupNameFilter
        - `name` 'experiment_group_name'
        - `operator` 'eq' | 'ne' | 'contains' | 'one_of' | 'not_in', required
        - `value` union, required
          - string
          - string[]
        - `case_sensitive` boolean
  - `sort` union
    - ExperimentNameSort
      - `name` 'name'
      - `ascending` boolean
      - `sort_type` 'column'
    - ExperimentCreatedAtSort
      - `name` 'created_at'
      - `ascending` boolean
      - `sort_type` 'column'
    - ExperimentUpdatedAtSort
      - `name` 'updated_at'
      - `ascending` boolean
      - `sort_type` 'column'
  - `include_counts` boolean

## Response `200`

Successful Response

- ListExperimentResponse
  - `starting_token` integer
  - `limit` integer
  - `paginated` boolean
  - `next_starting_token` integer, nullable
  - `experiments` 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)