---
title: "List executions"
method: GET
path: "/v1/workflows/{id}/executions"
tags: ["Workflows"]
---

# List executions

`GET /v1/workflows/{id}/executions`

## Request

- Base URL: `https://api.volanea.com`
- URL: `https://api.volanea.com/v1/workflows/{id}/executions`
- Auth: HTTP bearer

Enrolments in one workflow, newest first — each with the contact's email, where it currently sits in the graph, and what it is waiting on. Filter with `status` and cap with `limit`.

This is the log to read when a workflow "did nothing". An empty list means nothing ever enrolled, which is a trigger problem — check `POST /v1/events`'s `triggered` and `skipped` arrays. A list of `waiting` rows means enrolment worked and the contacts are sitting on a delay or an event that has not arrived, which is a graph problem. The two look identical from the outside and have nothing in common as fixes.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer
- `status` 'active' | 'waiting' | 'completed' | 'exited' | 'failed' | 'cancelled'

## Response `200`

Executions, newest first.

- object
  - `data` object[], required
    - `id` string, required
    - `contactId` string, required
    - `contactEmail` string, nullable
    - `status` 'active' | 'waiting' | 'completed' | 'exited' | 'failed' | 'cancelled', required
    - `currentNodeId` string, nullable
    - `wakeAt` string, date-time, nullable
    - `waitEventName` string, nullable
    - `enteredAt` string, date-time, required
    - `completedAt` string, date-time, nullable

## Other responses

- `401`: Missing or invalid API key.
- `404`: Not found.
- `422`: Request validation failed (code `validation_error`, 422).

---

[API](https://skmtc.dev/volanea/apis/volanea-api.md) · [All operations](https://skmtc.dev/volanea/apis/volanea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volanea/apis/volanea-api/revisions/9e187ae84fda?raw)