---
id: workflow-execution-list-steps
title: "List execution steps"
description: "Lists step attempts, paginated. Payloads are omitted by default (their sizes are reported instead); pass `include=payloads` for full rows."
sidebar_label: "List execution steps"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/api/workflows
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List execution steps"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/workflows/executions/{id}/steps"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Lists step attempts, paginated. Payloads are omitted by default (their sizes are reported instead); pass `include=payloads` for full rows.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"The execution id.","example":"exec_8f3a1b2c4d5e"},{"in":"query","name":"include","schema":{"type":"string"},"description":"Supported: `payloads`."},{"in":"query","name":"limit","schema":{"type":"integer","default":50,"maximum":500},"description":"The maximum number of results per page (clamped to 500).","example":50},{"in":"query","name":"offset","schema":{"type":"integer","minimum":0,"default":0},"description":"The starting point for pagination.","example":0}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The paginated step attempts.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"title":"Step","type":"object","description":"One step attempt. List responses omit `inputs`, `outputs`, and logs by default, advertising their size instead; pass `include=payloads` (or read a single step) for the full record.","properties":{"executionId":{"type":"string"},"stepId":{"type":"string","example":"detect_drift"},"stepName":{"type":"string"},"stepType":{"type":"string","example":"module"},"pluginType":{"type":"string","example":"code-exec"},"status":{"type":"string","enum":["pending","running","completed","failed","skipped","cancelled"]},"attempt":{"type":"integer","description":"1-based attempt number."},"iterationIndex":{"type":"integer","description":"0-based index when the step ran once per item."},"error":{"title":"StepError","type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"HTTP_500"},"message":{"type":"string"},"details":{"type":"object"},"retryable":{"type":"boolean"}}},"inputs":{"type":"object","description":"Only with `include=payloads` or on single-step reads."},"outputs":{"type":"object","description":"Only with `include=payloads` or on single-step reads."},"inputsBytes":{"type":"integer","description":"Serialized size of the omitted `inputs` (list responses)."},"outputsBytes":{"type":"integer","description":"Serialized size of the omitted `outputs` (list responses)."},"logCount":{"type":"integer","description":"Number of log entries the attempt produced (list responses)."},"metadata":{"type":"object"},"startedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"}}}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}}}}}},"4XX":{"description":"Client error. The body says what went wrong: an error `type`, a human-readable `detail`, and, on validation failures, one entry per offending field.","content":{"application/problem+json":{"schema":{"title":"Problem","type":"object","description":"The standard error body (RFC 7807 problem details, served as `application/problem+json`).","properties":{"type":{"type":"string","description":"Error type URI, e.g. `https://workflow-system.dev/errors/workflow-not-found`.","example":"https://workflow-system.dev/errors/workflow-not-found"},"title":{"type":"string","example":"Not found"},"status":{"type":"integer","example":404},"detail":{"type":"string","example":"No workflow with id wf_ifWBbWfpug0n exists"},"instance":{"type":"string","example":"/workflows/definitions/wf_ifWBbWfpug0n"},"errors":{"type":"array","description":"Present on validation failures: one entry per offending field.","items":{"type":"object","properties":{"path":{"type":"string","example":"/steps/scan/config"},"message":{"type":"string","example":"must have required property 'code'"}}}}}}}}},"5XX":{"description":"Unexpected server error.","content":{"application/problem+json":{"schema":{"title":"Problem","type":"object","description":"The standard error body (RFC 7807 problem details, served as `application/problem+json`).","properties":{"type":{"type":"string","description":"Error type URI, e.g. `https://workflow-system.dev/errors/workflow-not-found`.","example":"https://workflow-system.dev/errors/workflow-not-found"},"title":{"type":"string","example":"Not found"},"status":{"type":"integer","example":404},"detail":{"type":"string","example":"No workflow with id wf_ifWBbWfpug0n exists"},"instance":{"type":"string","example":"/workflows/definitions/wf_ifWBbWfpug0n"},"errors":{"type":"array","description":"Present on validation failures: one entry per offending field.","items":{"type":"object","properties":{"path":{"type":"string","example":"/steps/scan/config"},"message":{"type":"string","example":"must have required property 'code'"}}}}}}}}}}}
>
  
</StatusCodes>