---
title: "List automation runs"
method: GET
path: "/user/automate/flows/{id}/runs"
tags: ["Automations"]
---

# List automation runs

`GET /user/automate/flows/{id}/runs`

## Request

- Base URL: `https://app.famulor.de/api`
- URL: `https://app.famulor.de/api/user/automate/flows/{id}/runs`
- Auth: HTTP bearer

List a Famulor automation’s recent executions, or one execution’s step-by-step detail.

[Docs](https://docs.famulor.io/api-v1/automations/list-runs)

## Path parameters

- `id` string, required

## Query parameters

- `run_id` string
- `limit` integer

## Response `200`

OK

- object
  - `runs` object[]: The automation’s recent executions, newest first
    - `id` string: The run ID — pass it back as `run_id` for the step-by-step detail, or to [Retry automation run](/en/api-reference/automations/retry-run) 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
  - `run` object: The execution’s detail
    - `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` unknown[]: Per-step outcome — same shape as the `test.steps` of [Create automation](/en/api-reference/automations/create): `{name, status, classification, error}`, where `classification` is `ok`, `paused_at_delay`, `wiring_error`, `missing_connection` or `missing_record`
      - unknown

## Other responses

- `401`: Fehlender oder ungültiger API-Key.
- `404`: Not Found
- `422`: Die Anfrage ist inhaltlich ungültig.

---

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