> ## 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.

# Lister les exécutions d'automatisation

> Liste les exécutions récentes d'une automatisation Famulor, ou le détail étape par étape d'une exécution.

<Warning>
  **API Famulor 1.0 (héritée).** Cette page concerne uniquement Famulor 1.0 (`app.famulor.de`) et est conservée pour la compatibilité. Pour la plateforme actuelle, consultez la [référence API Famulor 2.0](/fr/api-reference/introduction).
</Warning>

Ce point de terminaison liste les exécutions récentes d'une automatisation (la plus récente en premier). Passez `run_id` pour obtenir le détail étape par étape d'une exécution, avec une classification par étape — c'est votre outil de débogage lorsqu'une automatisation échoue.

Une fois la cause de l'échec corrigée, relancez l'exécution depuis son étape en échec avec [Réessayer une exécution d'automatisation](/fr/api-v1/automations/retry-run) — récupérez l'`id` de l'exécution dans cette liste.

### Paramètres de chemin

<ParamField path="id" type="string" required>
  L'ID de l'automatisation (voir [Lister les automatisations](/fr/api-v1/automations/list))
</ParamField>

### Paramètres de requête

<ParamField query="run_id" type="string">
  Un ID d'exécution issu de la liste — renvoie le détail étape par étape de cette exécution au lieu de la liste
</ParamField>

<ParamField query="limit" type="integer">
  Le nombre d'exécutions récentes à lister (1 à 20, 10 par défaut)
</ParamField>

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

<ResponseField name="runs" type="array">
  Les exécutions récentes de l'automatisation, la plus récente en premier

  <Expandable title="Propriétés de l'exécution">
    <ResponseField name="id" type="string">
      L'ID de l'exécution — à renvoyer comme `run_id` pour le détail étape par étape, ou à [Réessayer une exécution d'automatisation](/fr/api-v1/automations/retry-run) pour une exécution en échec
    </ResponseField>

    <ResponseField name="status" type="string">
      `SUCCEEDED`, `FAILED`, `PAUSED` (arrêtée à une étape Delay en attente de son heure cible — ce n'est pas un échec) ou `RUNNING`
    </ResponseField>

    <ResponseField name="start_time" type="string">
      Date et heure de démarrage de l'exécution
    </ResponseField>

    <ResponseField name="duration_ms" type="integer">
      La durée de l'exécution en millisecondes
    </ResponseField>
  </Expandable>
</ResponseField>

### Response — Détail (avec `run_id`)

<ResponseField name="run" type="object">
  Le détail de l'exécution

  <Expandable title="Propriétés de l'exécution">
    <ResponseField name="id" type="string">
      L'ID de l'exécution
    </ResponseField>

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

    <ResponseField name="start_time" type="string">
      Date et heure de démarrage de l'exécution
    </ResponseField>

    <ResponseField name="duration_ms" type="integer">
      La durée de l'exécution en millisecondes
    </ResponseField>

    <ResponseField name="steps" type="array">
      Le résultat par étape — même forme que `test.steps` dans [Créer une automatisation](/fr/api-v1/automations/create) : `{name, status, classification, error}`, où `classification` vaut `ok`, `paused_at_delay`, `wiring_error`, `missing_connection` ou `missing_record`
    </ResponseField>
  </Expandable>
</ResponseField>

Une automatisation introuvable — ou qui n'appartient pas à votre compte — renvoie un `404` avec `{"message": "Automation not found"}`. Un `run_id` qui n'appartient pas à cette automatisation renvoie un `404` avec `{"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>
  Pages associées : [Réessayer une exécution d'automatisation](/fr/api-v1/automations/retry-run), [Mettre à jour une automatisation](/fr/api-v1/automations/update) et [Authentification](/fr/api-v1/authentication).
</Tip>