---
type: api
title: Get workflow step executions
description: **Spaces method and path for this operation:**
url: https://www.elastic.co/elastic/docs-builder/docs/4493/api/doc/kibana/v9/operation/operation-get-workflows-workflow-workflowid-executions-steps
resource: https://www.elastic.co/elastic/docs-builder/docs/4493/api/doc/kibana/v9/operation/operation-get-workflows-workflow-workflowid-executions-steps
products:
  - Kibana
---

# Get workflow step executions

Availability: Generally available since 9.4

- Server: `https://{kibana_url}`

## Paths

- `GET` `/api/workflows/workflow/{workflowId}/executions/steps`
- `GET` `/s/{space_id}/api/workflows/workflow/{workflowId}/executions/steps`

#### Path parameters

- `workflowId` (string) — required
  Workflow ID

## Description

Refer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.

Retrieve a paginated list of step-level execution records for a specific workflow. Optionally filter by step ID and include input or output data.

## Required authorization

- Privileges: `workflowsManagement:readExecution` or `workflowsManagement:managed:readExecution`

## Authentication

- Api key: `Authorization: <value>`
  These APIs use key-based authentication. You must create an API key and use the encoded value in the request header. For example: `Authorization: ApiKey base64AccessApiKey`
- Basic: `Authorization: Basic <credentials>`

## Query string parameters

- `stepId` (string) — optional
  Filter by step ID.
- `includeInput` (boolean) — optional
  Include step input data.
- `includeOutput` (boolean) — optional
  Include step output data.
- `page` (number · min: 1) — optional
  Page number for pagination.
- `size` (number · min: 1 · max: 100) — optional
  Number of results per page.
- `startedAfter` (string) — optional
  Datemath lower bound for filtering step executions by startedAt (inclusive when parsed).
- `startedBefore` (string) — optional
  Datemath upper bound for filtering step executions by startedAt (inclusive when parsed with roundUp).

## Response

Indicates a successful response

`application/json`

## Code examples

#### Console

```console
GET kbn://api/workflows/workflow/{workflowId}/executions/steps?includeInput=true
```

#### curl

```curl
curl \
  -X GET "${KIBANA_URL}/api/workflows/workflow/{workflowId}/executions/steps?includeInput=true" \
  -H "Authorization: ApiKey ${API_KEY}"
```

## Response examples

#### Get workflow step executions response

Example response returning step execution records for a workflow. The second entry shows a Human-In-The-Loop `wait_for_input` step that has been responded to: the `hitl` envelope is populated synchronously by the inbox respond path so every reader (Kibana Inbox UI, Slack, Agent Builder, raw API/MCP) sees a single canonical responder for the step.

```json
{
  "results": [
    {
      "executionTimeMs": 1000,
      "finishedAt": "2025-11-20T12:00:02.000Z",
      "globalExecutionIndex": 0,
      "id": "step-exec-001",
      "input": {
        "message": "hello world"
      },
      "isTestRun": false,
      "scopeStack": [],
      "spaceId": "default",
      "startedAt": "2025-11-20T12:00:01.000Z",
      "status": "completed",
      "stepExecutionIndex": 0,
      "stepId": "hello_world_step",
      "stepType": "console",
      "topologicalIndex": 0,
      "workflowId": "workflow-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "workflowRunId": "exec-001"
    },
    {
      "executionTimeMs": 329000,
      "finishedAt": "2025-11-20T12:05:31.000Z",
      "globalExecutionIndex": 1,
      "hitl": {
        "channel": "kibana-ui",
        "respondedAt": "2025-11-20T12:05:29.000Z",
        "respondedBy": "alice"
      },
      "id": "step-exec-002",
      "input": {
        "message": "Approve change to production?"
      },
      "isTestRun": false,
      "output": {
        "respondedBy": "alice",
        "response": {
          "approved": true
        }
      },
      "scopeStack": [],
      "spaceId": "default",
      "startedAt": "2025-11-20T12:00:02.000Z",
      "status": "completed",
      "stepExecutionIndex": 0,
      "stepId": "approve_change",
      "stepType": "wait_for_input",
      "topologicalIndex": 1,
      "workflowId": "workflow-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "workflowRunId": "exec-001"
    }
  ],
  "total": 2
}
```