Get Execution Status

Get the current status of a workflow execution. Returns the run's lifecycle state (`running`, `paused`, `completed`, `failed`, etc.), timing, error, and optionally per-block outputs. Designed for polling — works for any execution, including ones that pause and resume.

GET/api/workflows/{id}/executions/{executionId}

Authorization

apiKey
X-API-Key<token>

Your Sim API key (personal or workspace). Generate one from the Sim dashboard under Settings > API Keys.

In: header

Path Parameters

id*string

The unique identifier of the workflow.

executionId*string

The unique identifier of the execution.

Query Parameters

includeOutput?string

When true and the execution has status: completed, include the workflow's final output in the response.

Value in"true" | "false"
selectedOutputs?string

Comma-separated block-output selectors. A bare blockId returns that block's full output; a dot-path like blockId.field or blockId.nested.path returns just that value. Results are returned in the blockOutputs map keyed by the selector string.

Response Body

application/json

application/json

application/json

curl \  "https://www.sim.ai/api/workflows/{id}/executions/{executionId}" \  -H "X-API-Key: YOUR_API_KEY"

{
  "executionId": "9254f1c9-5a11-4a12-91e3-8065293f3609",
  "workflowId": "81f661e1-d704-4861-b5c1-5bb3cf57e6a7",
  "status": "completed",
  "trigger": "api",
  "level": "info",
  "startedAt": "2026-05-15T19:43:12.189Z",
  "endedAt": "2026-05-15T19:45:45.224Z",
  "totalDurationMs": 153035,
  "paused": null,
  "cost": {
    "total": 0.005
  },
  "error": null,
  "finalOutput": null,
  "blockOutputs": null
}

{
  "error": "string"
}
{
  "error": "string"
}