---
id: workflow-execution-read
title: "Read an execution"
description: "Returns the execution record. Large final snapshots are omitted by default and their size reported as `finalSnapshotBytes`; pass `include=finalSnapshot` for the full payload."
sidebar_label: "Read an execution"
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 an execution"}
>
</Heading>

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



Returns the execution record. Large final snapshots are omitted by default and their size reported as `finalSnapshotBytes`; pass `include=finalSnapshot` for the full payload.

<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":"Comma-separated extras. Supported: `finalSnapshot`.","example":"finalSnapshot"}]}
>
  
</ParamsDetails>

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

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The execution.","content":{"application/json":{"schema":{"title":"Execution","type":"object","required":["id","workflowId","revision","status","inputs","startedAt","updatedAt"],"properties":{"id":{"type":"string","example":"exec_8f3a1b2c4d5e"},"workflowId":{"type":"string","example":"wf_ifWBbWfpug0n"},"revision":{"type":"integer","example":3},"aliasName":{"type":"string","example":"live"},"organizationId":{"type":"string"},"correlationKey":{"type":"string","description":"Client-chosen key used to target the execution with signals."},"idempotencyKey":{"type":"string"},"status":{"type":"string","enum":["pending","running","completed","failed","cancelled","timed_out"]},"inputs":{"type":"object","description":"Run inputs. Credential-named keys are masked on reads."},"outputs":{"type":"object"},"variables":{"type":"object"},"error":{"title":"StepError","type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"HTTP_500"},"message":{"type":"string"},"details":{"type":"object"},"retryable":{"type":"boolean"}}},"parentExecutionId":{"type":"string","description":"Present on sub-workflow executions."},"parentStepId":{"type":"string"},"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>