---
title: "List Experiment Groups"
method: POST
path: "/projects/{project_id}/experiment-groups/query"
tags: ["experiment_group"]
---

# List Experiment Groups

`POST /projects/{project_id}/experiment-groups/query`

List experiment groups for a project with filtering, sorting, and pagination.

## Path parameters

- `project_id` string, uuid4, required

## Request body

- ExperimentGroupSearchRequest — Search/list experiment groups with filtering, sorting, and pagination.
  - `starting_token` integer
  - `limit` integer
  - `filters` union[]
    - union
      - ApiSchemasExperimentGroupExperimentGroupIDFilter
        - `name` 'id'
        - `operator` 'eq' | 'ne' | 'one_of' | 'not_in' | 'contains'
        - `value` union, required
          - string, uuid4
          - union[]
            - union
              - …
          - string
      - ApiSchemasExperimentGroupExperimentGroupNameFilter
        - `name` 'name'
        - `operator` 'eq' | 'ne' | 'contains' | 'one_of' | 'not_in', required
        - `value` union, required
          - string
          - string[]
        - `case_sensitive` boolean
      - ExperimentGroupCreatedAtFilter
        - `name` 'created_at'
        - `operator` 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte', required
        - `value` string, date-time, required
      - ExperimentGroupLatestActivityFilter
        - `name` 'latest_activity'
        - `operator` 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte', required
        - `value` string, date-time, required
      - ExperimentGroupCreatedByFilter
        - `name` 'created_by'
        - `operator` 'eq' | 'ne' | 'one_of' | 'not_in' | 'contains'
        - `value` union, required
          - string, uuid4
          - union[]
            - union
              - …
          - string
      - ExperimentGroupIsSystemFilter
        - `name` 'is_system'
        - `operator` 'eq' | 'ne'
        - `value` boolean, required
  - `sort` union
    - ExperimentGroupNameSort
      - `name` 'name'
      - `ascending` boolean
      - `sort_type` 'column'
    - ExperimentGroupCreatedAtSort
      - `name` 'created_at'
      - `ascending` boolean
      - `sort_type` 'column'
    - ExperimentGroupLatestActivitySort
      - `name` 'latest_activity'
      - `ascending` boolean
      - `sort_type` 'column'

## Response `200`

Successful Response

- ExperimentGroupListResponse — Paginated response for listing experiment groups.
  - `starting_token` integer
  - `limit` integer
  - `paginated` boolean
  - `next_starting_token` integer, nullable
  - `experiment_groups` ExperimentGroupResponse[]
    - `id` string, uuid4, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `name` string, required
    - `project_id` string, uuid4, required
    - `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
    - `description` string, nullable
    - `is_system` boolean
    - `experiment_count` integer
    - `latest_run_date` string, date-time, nullable
    - `datasets` ExperimentGroupDatasetResponse[]
      - `id` string, uuid4, required
      - `name` string, required

## 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)