---
id: workflow-execution-state
title: "Read execution state"
description: "Returns a live state snapshot: per-step outputs, current steps, pending signal waits, variables, and run metadata. Queried live while the execution runs; rebuilt from storage afterwards."
sidebar_label: "Read execution state"
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={"Read execution state"}
>
</Heading>

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



Returns a live state snapshot: per-step outputs, current steps, pending signal waits, variables, and run metadata. Queried live while the execution runs; rebuilt from storage afterwards.

<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"}]}
>
  
</ParamsDetails>

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

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The state snapshot.","content":{"application/json":{"schema":{"type":"object","properties":{"executionId":{"type":"string"},"workflowId":{"type":"string"},"revision":{"type":"integer"},"status":{"type":"string","enum":["pending","running","completed","failed","cancelled","timed_out"]},"inputs":{"type":"object"},"variables":{"type":"object"},"outputs":{"type":"object","description":"Present once the execution completed."},"steps":{"type":"object","description":"Map of step id to its latest outputs and status."},"currentSteps":{"type":"array","items":{"type":"string"}},"pendingWaits":{"type":"array","items":{"title":"PendingWait","type":"object","description":"A signal wait the execution is currently parked on.","properties":{"executionId":{"type":"string"},"waitId":{"type":"string"},"stepId":{"type":"string"},"workflowId":{"type":"string"},"revision":{"type":"integer"},"correlationKey":{"type":"string"},"signalNames":{"type":"array","items":{"type":"string"},"example":["approval:response"]},"timeoutDeadline":{"type":"string","format":"date-time"},"onTimeout":{"type":"string","enum":["continue","error","resolve-with-default"]},"createdAt":{"type":"string","format":"date-time"},"metadata":{"type":"object"}}}},"startedAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"}}}}}},"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>