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

# List Experiments Paginated

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

Retrieve all experiments for a project with pagination.

## Path parameters

- `project_id` string, uuid4, required

## Query parameters

- `include_counts` boolean
- `starting_token` integer
- `limit` integer

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