# List executions

> Recent executions of one workflow, newest first.

Source: https://docs.generalinput.com/api/workflows/list-executions



<Endpoint method="GET" path="/v1/workflows/:id/executions" />

<Access scope="workflows:manage" />

## Query parameters [#query-parameters]

| Name    | Type    | Notes                 |
| ------- | ------- | --------------------- |
| `limit` | integer | 1 to 100. Default 20. |

## Response [#response]

```json
{
  "executions": [
    {
      "id": "exec_01HX…",
      "status": "completed",
      "isTest": true,
      "eventDescription": "Triggered by Jack Joliet",
      "name": "Posted 12 stories to #engineering",
      "createdAt": "2026-09-03T10:00:00.000Z",
      "completedAt": "2026-09-03T10:00:41.000Z"
    }
  ]
}
```

`status` is one of `initializing`, `scheduled`, `running`, `awaiting_input`, `completed`, `failed`, `cancelled`, `skipped`, or `filtered`. A run reads `filtered` when the workflow's `filter.ts` returned `skip`. `name` is a generated per-run title when one exists; fall back to `eventDescription`.