> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lacy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List automation runs

> List an automation's recent executions, or one execution's step-by-step detail

This endpoint lists an automation's recent executions (newest first). Pass `run_id` to get one execution's step-by-step detail with a per-step classification — this is your debugger when an automation is failing.

Once you have fixed what made a run fail, retry it from its failed step with [Retry automation run](https://docs.lacy.ai/api-reference/automations/retry-automation-run.md) — take the run's id from this list.

### Path Parameters

**id** `string` *required*

The ID of the automation (from [List automations](https://docs.lacy.ai/api-reference/automations/list-automations.md))

### Query Parameters

**run\_id** `string`

A run ID from the list — returns that run's step-by-step detail instead of the list

**limit** `integer`

How many recent runs to list (1–20, default 10)

### Response — list (no `run_id`)

**runs** `array`

The automation's recent executions, newest first

**run properties**

**id** `string`

The run ID — pass it back as `run_id` for the step-by-step detail, or to [Retry automation run](https://docs.lacy.ai/api-reference/automations/retry-automation-run.md) for a failed run

**status** `string`

`SUCCEEDED`, `FAILED`, `PAUSED` (parked at a Delay step waiting for its target time — not a failure) or `RUNNING`

**start\_time** `string`

When the run started

**duration\_ms** `integer`

The run's duration in milliseconds

### Response — detail (with `run_id`)

**run** `object`

The execution's detail

**run properties**

**id** `string`

The run ID

**status** `string`

`SUCCEEDED`, `FAILED`, `PAUSED` or `RUNNING`

**start\_time** `string`

When the run started

**duration\_ms** `integer`

The run's duration in milliseconds

**steps** `array`

Per-step outcome — same shape as the `test.steps` of [Create automation](https://docs.lacy.ai/api-reference/automations/create-automation.md): `{name, status, classification, error}`, where `classification` is `ok`, `paused_at_delay`, `wiring_error`, `missing_connection` or `missing_record`

A missing automation — or one that does not belong to your account — returns a `404` with `{"message": "Automation not found"}`. A `run_id` that does not belong to this automation returns a `404` with `{"message": "Run not found for this automation"}`.

```json 200 Response (list) theme={null}
{
  "runs": [
    {
      "id": "yHhXbqWj3zJZ5ztDNfUry",
      "status": "SUCCEEDED",
      "start_time": "2026-07-24T18:23:59.634Z",
      "duration_ms": 1
    },
    {
      "id": "x2PqLm90AbCdEfGhIjKlM",
      "status": "FAILED",
      "start_time": "2026-07-24T17:10:12.000Z",
      "duration_ms": 410
    }
  ]
}
```

```json 200 Response (detail) theme={null}
{
  "run": {
    "id": "x2PqLm90AbCdEfGhIjKlM",
    "status": "FAILED",
    "start_time": "2026-07-24T17:10:12.000Z",
    "duration_ms": 410,
    "steps": [
      { "name": "trigger", "status": "SUCCEEDED", "classification": "ok", "error": null },
      {
        "name": "step_1",
        "status": "FAILED",
        "classification": "missing_connection",
        "error": "Request failed with status code 401"
      }
    ]
  }
}
```

```json 404 Response theme={null}
{
  "message": "Run not found for this automation"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.