Skip to main content
List workflow executions
curl --request GET \
  --url https://api.maildiver.com/v1/workflows/{id}/executions \
  --header 'Authorization: Bearer <token>'
{
  "executions": [
    {
      "execution_id": "0195c9e3-5067-741d-be87-a4f75ef93372",
      "workflow_id": "0199f234-d327-7cd8-9dc5-4fd8e5e249df",
      "workspace_id": "0195a927-b706-725a-94dd-372770d920f2",
      "version_used": 1,
      "status": "COMPLETED",
      "current_step_id": "step_send_email",
      "email": "user@example.com",
      "step_count": 3,
      "created_at": 1742843423033,
      "updated_at": 1742843424100,
      "completed_at": 1742843424147,
      "error": null,
      "cancellation_reason": null
    },
    {
      "execution_id": "0195c413-3fe1-779d-804e-f5f9bd8cd523",
      "workflow_id": "0199f234-d327-7cd8-9dc5-4fd8e5e249df",
      "workspace_id": "0195a927-b706-725a-94dd-372770d920f2",
      "version_used": 1,
      "status": "WAITING",
      "current_step_id": "step_wait",
      "email": "customer@example.com",
      "step_count": 2,
      "created_at": 1742751354368,
      "updated_at": 1742751354400,
      "completed_at": null,
      "error": null,
      "cancellation_reason": null,
      "wait_until": 1742837754368
    }
  ],
  "count": 2,
  "cursor": null
}

Authorizations

Authorization
string
header
required

API key with format "Bearer {your-api-key}"

Path Parameters

id
string
required

Unique identifier of the workflow

Query Parameters

cursor
string | null

Pagination cursor for fetching the next page of results. This is a base64-encoded string returned from the previous response.

status
enum<string>

Filter executions by status

Available options:
IN_PROGRESS,
WAITING,
COMPLETED,
FAILED,
CANCELLED

Response

OK

The response is of type any.

I