---
title: cascades_get_execution
description: Fetch a single cascade execution by id to check its status and results.
canonical_url: "https://cascades.crscreditapi.com/docs/mcp/tools/cascades_get_execution"
doc_version: "1.0.0"
last_updated: "2026-10-09T14:37:54Z"
source: docs/mcp/tools.json
---

# `cascades_get_execution`

Fetch a single cascade execution by id to check its status and results. Use this to poll after cascades_trigger_workflow until the run reaches a terminal status, and to read the decision: with full read access the response includes `step_outputs` (the per-step results) and `input_context`. Statuses: queued / pending / running / waiting / awaiting_review / completed / failed / cancelled / skipped.

- **Access:** read
- **Scopes:** `executions:read`
- **REST operation:** `GET /api/v1/executions/{id}` — [getExecution](https://cascades.crscreditapi.com/docs/api/executions/get-execution.md)

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `execution_id` | `integer` | yes | Execution id. Scoped to the calling api_client; a foreign id returns `404`. |
| `environment` | `string` | no | Target environment: "prod" (default) or "dev". One of: `dev`, `prod`. |

## Example call

```json
{
  "name": "cascades_get_execution",
  "arguments": {
    "execution_id": 4821
  }
}
```

## Example result

```json
{
  "data": {
    "id": 4821,
    "object": "execution",
    "workflow_id": 157,
    "status": "completed",
    "decision": "approve",
    "step_outputs": {
      "credit": {
        "score": 712
      },
      "decision": {
        "outcome": "approve"
      }
    }
  }
}
```

## Sitemap

See the full [sitemap](https://cascades.crscreditapi.com/sitemap.md) for all pages.