Vantax AIDocs
GET

List Executions

Lists the runs of a Workflow, newest-first.

GEThttps://api.vantaxai.com/v1/workflows/{workflow_id}/executions

Each execution is a single firing of the Workflow's trigger. The list returns a summary of each run — use Get Execution to inspect the per-step results.

Headers

  • Authorizationstringrequired

    Bearer authentication with your secret API key.

    example: Bearer vx_live_3fa9c2…

Path Parameters

  • workflow_idstringrequired

    The Workflow whose executions to list.

    example: wf_4c81a0

Query Parameters

  • limitintegeroptional

    Number of records to return (1–200). Defaults to 50.

    example: 50

  • statusstringoptional

    Filter executions by status.

    pendingrunningcompletedfailed

Request

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

Response

{
  "success": true,
  "data": [
    {
      "id": "exec_7b2e91",
      "workflow_id": "wf_4c81a0",
      "status": "completed",
      "trigger_event": {
        "type": "contact.created",
        "contact_id": "ct_91ad22"
      },
      "started_at": "2026-02-02T08:12:00Z",
      "finished_at": "2026-02-02T08:12:04Z"
    },
    {
      "id": "exec_5a90fd",
      "workflow_id": "wf_4c81a0",
      "status": "failed",
      "trigger_event": {
        "type": "contact.created",
        "contact_id": "ct_44be01"
      },
      "started_at": "2026-02-01T17:45:10Z",
      "finished_at": "2026-02-01T17:45:11Z"
    }
  ],
  "pagination": {
    "total": 2,
    "limit": 50,
    "has_more": false
  }
}