---
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: >-
  eJztWO9v2zYQ/VcO/NIWU+y0S9FC+5R17dANK9o0RQoEQX0WTzYbiVTJkx3D0P8+HCU5dqwkzYABG9BPlsxfd4/vvSO1VoyzoNJzdeb8ZV64JdAVZTUbZ4O6SJSmkHlTybtK1Qlx7W0AhMIsCAIjEwSLVZg7TqEifxCYKnA1VzWHBLLae7IM8m9IoCKrjZ1BMDOLBSzRSKcFeoPTgkICaDX42kJJjBoZR/ChJm9Itwsu56Yg4DldRyndwy/gaVqbgiH3roTAzuOMAHMmv0Svw0glylXkUYa81SpVyy7fg81MaUxHJapCjyUxeQFmrYxkXiHPVaIslqRSZbRKlKdvtfGkVcq+pkSFbE4lqnSteFVJr8De2JlqbqJ4uhO/0RIcXWFZFTJKWr68zH/Gp9Nn2ZF+Tqq5SFSgrPaGVzGiKaEnf1zzXKXnF9LsKVTOBgqy/LPDQ/nZX3R3v2TZzFkmy9Idq6owWQRo/DXImPV+Sm76lTIWjLzAyaZdcZONQDuQfw/2Lc2eFiaYdsmu0VimGXlplajrsD8wUWTrUrjb0Ur2pLa2fcqc4MkkO5WjKeJDhjajon1mU5L+4mpWF02ijBXC7mfaJGpDz8HWjupDGO1uwHtPQaTgbHaTwptYR22+VH3HfH9hBS6PygKjgR0YDlAgU+BegFFPLX5x6k6OH2+sgN7jSiXKMJUDQDdN0kN8Joq9c6ThyOL31/0F6zszOd72gxvQmNB7SLGCCv0laXB29HAGouFbmgTBf4O3mfOeiiioP2k1vHTM+x2W9JDt2HKLc5Gtdwss0t4CIp2F3K7m3wh1YSwNiSd3vkRWqdLIdCADIp3taTv0Lr2Jaxhbi1eS985HMwyuWNDB0vD8QFOOddEKK/OETPp4cMLhGHrzH9Bb07SG4B84ZV3ph0axEeX3D2ra+I4+f97331eFEfVHvEYgbjx1egUBVwGWc2RYSvPSOztLAW3bESay7CQBhHldoj3whFq8CCaaGE0xiSUzAWdhgYXRkW0gfld7qafOEpBlv5LaDC7PuwKcGyr0HQWg8m5aUPnTQCHoBd72uFfcXd2xGr3ukoqJPz558wpevDx8Ad1a0GYUEgjkF6QBA0xui2nyZN8C2jj2d2o3ntcxBOkDn07eJkCj2Qgmc+YqpOPx5lQQVoGpHGlajGPQ4brJOj7IXW31ZLdw/6M5VBRrhHRAb5u53zmGTf+9gtibztaIo8OjeO4QSO+bGvqwQNQrxWSZfzH52a/Ts7yqZ4cW6MoEDirWSdnM7J5wN4mGsabcWBPPk+Mb00Yni8AMmN9txXOI5+n9PL/ppbccZOIx7+7UYnkehwztOHM2N7PWskLA2T2olHVgmOOCoD86Qrf6Ch5lTtOjzkKiizwfcpFPlq4qyph0qxLfGcoPJf9Q8g8l/yeV3B5o5k4unTOKgcbQtqG9vnOP10Y34/4m2mq8vYbWvtiiJlZmZOuiqApkOYqMMlfuXBQ/is5bKLavi5usZCLVXVrlve2kku7hTX+8+ePsNF4AjM2dDJd42p18OjocHaoN6dW7rXDg+P1bQbNygUuMxtNdnU8I9db5vs90hyTrazP7f39y6LBmuuJxVaCJQokb2RP0fHPHCJFhm28viUrjV4YWoItEzV1g6b9eTzHQJ180jfz9rSYvXwUuri+qkS7aBHnWKs2xCHQHwo9POg4/gaEvE4M59BK3IvAFFrW8qURdykVHPo80cvafE2ryMZy24TjLqOKtIXsfHYTCG7n8/vpUJQp3iXuDqHH2wXDW67bHqbsk2zSb6FjeJcCm+Rv426iB
sidebar_class_name: get api-method
info_path: docs/api/nullplatform-api
custom_edit_url: null
canonical: 'https://docs.nullplatform.com/docs/api/workflow-execution-state'
---
<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>