---
title: "List Experiments"
method: GET
path: "/api/v1/experiments"
tags: ["experiments"]
---

# List Experiments

`GET /api/v1/experiments`

## Query parameters

- `xids` string, nullable — Comma-separated exact XIDs to fetch.
- `xid_prefix` string, nullable — Return experiments matching a numeric XID prefix, ordered by XID ascending.
- `after` string, nullable — Only experiments created at or after this timestamp.
- `before` string, nullable — Only experiments created at or before this timestamp.
- `experiment_name` string, nullable — Case-insensitive experiment name substring.
- `user` string, nullable — Filter by display user, email, or user id.
- `status` string, nullable — Filter by raw experiment status.
- `config_query` string, nullable — Filter by config path equality or substring.
- `cursor` string, nullable
- `limit` integer
- `sort` string, nullable
- `order` 'asc' | 'desc'
- `search` string, nullable

## Response `200`

Successful Response

- PaginatedResponseExperimentSummary
  - `items` ExperimentSummary[], required
    - `xid` string, required
    - `experiment_name` string, nullable
    - `user_email` string, nullable
    - `user_id` string, nullable
    - `user` string, nullable
    - `status` string, nullable
    - `is_externally_visible` boolean
    - `created_at` string, nullable
    - `updated_at` string, nullable
    - `git_sha` string, nullable
    - `git_base_sha` string, nullable
    - `wandb_url` string, nullable
    - `aim_url` string, nullable
    - `tempo_url` string, nullable
    - `pyroscope_url` string, nullable
    - `logging_url` string, nullable
    - `started_at` string, nullable
    - `ended_at` string, nullable
    - `error_message` string, nullable
    - `job_type` string, nullable
    - `kubernetes_job_name` string, nullable
    - `cpu_kubernetes_job_name` string, nullable
    - `cpu_cluster_name` string, nullable
    - `tcli_gpu_cluster_name` string, nullable
    - `training_backend_mode` string, nullable
    - `cost_status` string, nullable
    - `cost_total_usd` number, nullable
    - `cost_breakdown` object, nullable
    - `runner` string, nullable
    - `entry_type` string, nullable
    - `autoresearch_ui_url` string, nullable
    - `code_state_uri` string, nullable
  - `next_cursor` string, nullable
  - `has_more` boolean, required

## Changes

- **2026-09-23** `1f15ecf92088` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/trajectory/apis/trajectory-api/changes/api/v1/experiments/get.md)

---

[API](https://skmtc.dev/trajectory/apis/trajectory-api.md) · [All operations](https://skmtc.dev/trajectory/apis/trajectory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trajectory/apis/trajectory-api/revisions/8331f8435ce8?raw)