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

# Automation-Runs auflisten

> Liste die letzten Ausführungen einer Famulor-Automation oder die Step-für-Step-Details eines Laufs.

Dieser Endpunkt listet die letzten Ausführungen einer Automation (neueste zuerst). Mit `run_id` erhältst du die Step-für-Step-Details eines Laufs inkl. Klassifikation — dein Debugger, wenn eine Automation fehlschlägt.

Nachdem du die Ursache behoben hast, starte den Lauf mit [Run erneut versuchen](/de/api-reference/automations/retry-run) ab dem fehlgeschlagenen Step neu — nimm die `id` aus dieser Liste.

### Path Parameters

<ParamField path="id" type="string" required>
  Die ID der Automation (aus [Automationen auflisten](/de/api-reference/automations/list))
</ParamField>

### Query Parameters

<ParamField query="run_id" type="string">
  Eine Run-ID aus der Liste — liefert die Step-für-Step-Details dieses Laufs statt der Liste
</ParamField>

<ParamField query="limit" type="integer">
  Wie viele aktuelle Runs gelistet werden (1–20, Standard 10)
</ParamField>

### Response — Liste (ohne `run_id`)

<ResponseField name="runs" type="array">
  Die letzten Ausführungen der Automation, neueste zuerst

  <Expandable title="Run-Eigenschaften">
    <ResponseField name="id" type="string">
      Die Run-ID — als `run_id` für die Details oder an [Run erneut versuchen](/de/api-reference/automations/retry-run) für einen fehlgeschlagenen Lauf übergeben
    </ResponseField>

    <ResponseField name="status" type="string">
      `SUCCEEDED`, `FAILED`, `PAUSED` (wartet an einem Delay-Step auf die Zielzeit — kein Fehler) oder `RUNNING`
    </ResponseField>

    <ResponseField name="start_time" type="string">
      Startzeitpunkt des Laufs
    </ResponseField>

    <ResponseField name="duration_ms" type="integer">
      Dauer des Laufs in Millisekunden
    </ResponseField>
  </Expandable>
</ResponseField>

### Response — Detail (mit `run_id`)

<ResponseField name="run" type="object">
  Die Details der Ausführung

  <Expandable title="Run-Eigenschaften">
    <ResponseField name="id" type="string">
      Die Run-ID
    </ResponseField>

    <ResponseField name="status" type="string">
      `SUCCEEDED`, `FAILED`, `PAUSED` oder `RUNNING`
    </ResponseField>

    <ResponseField name="start_time" type="string">
      Startzeitpunkt des Laufs
    </ResponseField>

    <ResponseField name="duration_ms" type="integer">
      Dauer des Laufs in Millisekunden
    </ResponseField>

    <ResponseField name="steps" type="array">
      Ergebnis pro Step — gleiche Form wie `test.steps` von [Automation erstellen](/de/api-reference/automations/create): `{name, status, classification, error}`, wobei `classification` `ok`, `paused_at_delay`, `wiring_error`, `missing_connection` oder `missing_record` ist
    </ResponseField>
  </Expandable>
</ResponseField>

Eine fehlende Automation — oder eine, die nicht zu deinem Account gehört — liefert `404` mit `{"message": "Automation not found"}`. Eine `run_id`, die nicht zu dieser Automation gehört, liefert `404` mit `{"message": "Run not found for this automation"}`.

<ResponseExample>
  ```json 200 Response (Liste) theme={null} 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} 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 Not Found theme={null} theme={null}
  {
    "message": "Run not found for this automation"
  }
  ```
</ResponseExample>

<Tip>
  Verwandte Seiten: [Run erneut versuchen](/de/api-reference/automations/retry-run), [Automation aktualisieren](/de/api-reference/automations/update) und [Authentifizierung](/de/api-reference/authentication).
</Tip>