---
title: "List experiments"
method: GET
path: "/api/v1/automations/{id}/experiments"
tags: ["Evaluation"]
---

# List experiments

`GET /api/v1/automations/{id}/experiments`

List experiment batches for one automation. Each experiment runs selected dataset examples and records automated evaluator scores.

## Path parameters

- `id` string, required — Automation id or typed alias.

## Query parameters

- `limit` integer — Maximum number of experiment batches to return.
- `offset` integer — Zero-based offset for paging through experiment batches.
- `fromDate` string — Filter to experiment batches created at or after this date or relative date.
- `toDate` string — Filter to experiment batches created at or before this date or relative date.

## Response `200`

Page of experiment batches.

- object
  - `data` Experiment[], required
    - `id` string, required — Experiment batch id. Some CLI commands historically call this a batch id.
    - `automationId` string, required — Automation this experiment belongs to.
    - `automationType` 'workflow' | 'agent', required
    - `status` 'queued' | 'running' | 'completed', required — Experiment batch status.
    - `runCount` integer, required — Total runs in the experiment.
    - `completedCount` integer, required — Runs that have completed.
    - `passedCount` integer, required — Runs whose evaluator scores passed.
    - `failedCount` integer, required — Runs whose evaluator scores failed.
    - `avgScore` number, nullable, required — Average automated evaluator score.
    - `createdAt` union, required
      - string
      - string
    - `completedAt` union, required
      - string
      - string
    - `version` string, nullable, required
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `400` — Validation error. Request shape did not match the spec.
- `401` — Missing or invalid API key
- `403` — API key lacks required scope
- `404` — Resource not found
- `413` — Payload too large. Upload exceeded the per-request size cap.
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/eigenpal/apis/eigenpal-api.md) · [All operations](https://skmtc.dev/eigenpal/apis/eigenpal-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/eigenpal/eigenpal-api/revisions/dddcddf1975c/schema)