GET

Get Execution

Retrieves a single execution, including per-step results.

GEThttps://api.vantaxai.com/v1/executions/{execution_id}

The `step_results` array mirrors the Workflow's `steps`, reporting a `status` for each one (`completed`, `failed`, or `skipped`) along with timestamps and any output or error. This is the primary tool for debugging why a run behaved the way it did.

Headers

Authorizationstringrequired
Bearer authentication with your secret API key.
example: Bearer vx_live_3fa9c2…

Path Parameters

execution_idstringrequired
The execution's unique identifier.
example: exec_5a90fd

Request

curl -X GET https://api.vantaxai.com/v1/executions/exec_5a90fd \
  -H "Authorization: Bearer vx_live_3fa9c2..."

const res = await fetch(
  "https://api.vantaxai.com/v1/executions/exec_5a90fd",
  {
  method: "GET",
  headers: {
    Authorization: "Bearer vx_live_3fa9c2...",
  },
  }
);
const { data } = await res.json();

import { Vantax } from "@vantax/sdk";

const vantax = new Vantax({ apiKey: process.env.VANTAX_API_KEY! });
// GET /v1/executions/{execution_id}
const result = await vantax.request("GET", "/v1/executions/{execution_id}");

from vantax import Vantax

vantax = Vantax(api_key=os.environ["VANTAX_API_KEY"])
# GET /v1/executions/{execution_id}
result = vantax.request("GET", "/v1/executions/{execution_id}")

Response

{
  "success": true,
  "data": {
    "id": "exec_5a90fd",
    "workflow_id": "wf_4c81a0",
    "status": "failed",
    "trigger_event": {
      "type": "contact.created",
      "contact_id": "ct_44be01",
      "source": "website"
    },
    "step_results": [
      {
        "step_id": "step_send_sms",
        "type": "send_sms",
        "status": "completed",
        "output": { "message_id": "msg_2f81c0" },
        "started_at": "2026-02-01T17:45:10Z",
        "finished_at": "2026-02-01T17:45:11Z"
      },
      {
        "step_id": "step_add_tag",
        "type": "add_tag",
        "status": "failed",
        "error": "Tag tag_9f02 not found in sub-account",
        "started_at": "2026-02-01T17:45:11Z",
        "finished_at": "2026-02-01T17:45:11Z"
      }
    ],
    "started_at": "2026-02-01T17:45:10Z",
    "finished_at": "2026-02-01T17:45:11Z"
  }
}

{ "success": false, "message": "Execution not found" }