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

# Listar ejecuciones de automatización

> Lista las ejecuciones recientes de una automatización de Famulor, o el detalle paso a paso de una ejecución concreta.

<Warning>
  **API de Famulor 1.0 (legado).** Esta página se aplica únicamente a Famulor 1.0 (`app.famulor.de`) y se conserva por compatibilidad. Para la plataforma actual, usa la [referencia de la API de Famulor 2.0](/es/api-reference/introduction).
</Warning>

Este endpoint lista las ejecuciones recientes de una automatización (las más nuevas primero). Pasa `run_id` para obtener el detalle paso a paso de una ejecución concreta con una clasificación por paso — este es tu depurador cuando una automatización está fallando.

Una vez que hayas corregido lo que provocó el fallo de una ejecución, reinténtala desde su paso fallido con [Reintentar ejecución de automatización](/es/api-v1/automations/retry-run) — toma el `id` de la ejecución de esta lista.

### Parámetros de ruta

<ParamField path="id" type="string" required>
  El ID de la automatización (de [Listar automatizaciones](/es/api-v1/automations/list))
</ParamField>

### Parámetros de consulta

<ParamField query="run_id" type="string">
  Un ID de ejecución de la lista — devuelve el detalle paso a paso de esa ejecución en lugar de la lista
</ParamField>

<ParamField query="limit" type="integer">
  Cuántas ejecuciones recientes listar (1–20, por defecto 10)
</ParamField>

### Respuesta — lista (sin `run_id`)

<ResponseField name="runs" type="array">
  Las ejecuciones recientes de la automatización, las más nuevas primero

  <Expandable title="Propiedades de la ejecución">
    <ResponseField name="id" type="string">
      El ID de la ejecución — pásalo de vuelta como `run_id` para el detalle paso a paso, o a [Reintentar ejecución de automatización](/es/api-v1/automations/retry-run) para una ejecución fallida
    </ResponseField>

    <ResponseField name="status" type="string">
      `SUCCEEDED`, `FAILED`, `PAUSED` (detenida en un paso de Retraso esperando su hora objetivo — no es un fallo) o `RUNNING`
    </ResponseField>

    <ResponseField name="start_time" type="string">
      Cuándo comenzó la ejecución
    </ResponseField>

    <ResponseField name="duration_ms" type="integer">
      La duración de la ejecución en milisegundos
    </ResponseField>
  </Expandable>
</ResponseField>

### Respuesta — detalle (con `run_id`)

<ResponseField name="run" type="object">
  El detalle de la ejecución

  <Expandable title="Propiedades de la ejecución">
    <ResponseField name="id" type="string">
      El ID de la ejecución
    </ResponseField>

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

    <ResponseField name="start_time" type="string">
      Cuándo comenzó la ejecución
    </ResponseField>

    <ResponseField name="duration_ms" type="integer">
      La duración de la ejecución en milisegundos
    </ResponseField>

    <ResponseField name="steps" type="array">
      Resultado por paso — la misma forma que `test.steps` de [Crear automatización](/es/api-v1/automations/create): `{name, status, classification, error}`, donde `classification` es `ok`, `paused_at_delay`, `wiring_error`, `missing_connection` o `missing_record`
    </ResponseField>
  </Expandable>
</ResponseField>

Una automatización inexistente — o que no pertenece a tu cuenta — devuelve un `404` con `{"message": "Automation not found"}`. Un `run_id` que no pertenece a esta automatización devuelve un `404` con `{"message": "Run not found for this automation"}`.

<ResponseExample>
  ```json 200 Response (list) 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>
  Páginas relacionadas: [Reintentar ejecución de automatización](/es/api-v1/automations/retry-run), [Actualizar automatización](/es/api-v1/automations/update), y [Autenticación](/es/api-v1/authentication).
</Tip>