---
title: "List workflows"
method: POST
path: "/workflows/list"
tags: ["Workflows"]
---

# List workflows

`POST /workflows/list`

## Request

- Base URL: `https://api.reacherapp.com/public/v1`
- URL: `https://api.reacherapp.com/public/v1/workflows/list`
- Auth: API key in header `x-api-key` and API key in header `x-shop-id`

Your workflows for one shop, each with its step and branch counts, whether it has unpublished changes, and its enrolled / in-progress / sends / reached / GMV metrics. Archived workflows are left out unless `include_archived` is true.

## Request body

- WorkflowListBody
  - `include_archived` boolean: Include archived workflows in the result.

## Response `200`

Successful Response

- EnvelopeListWorkflowSummaryPublic
  - `data` WorkflowSummaryPublic[], required
    - `workflow_id` string, required
    - `shop_id` integer, required
    - `name` string, required
    - `description` string, nullable
    - `status` string, required: draft, running, paused, archived or template.
    - `version` integer, required: Incremented on each publish.
    - `trigger_type` string, required: creator_matches or recurring.
    - `step_count` integer, required
    - `branch_count` integer, required
    - `has_unpublished_changes` boolean, required: The draft differs from what the runtime is walking.
    - `created_from` object, nullable
    - `published_at` string, nullable
    - `created_at` string, required
    - `updated_at` string, required
    - `enrolled` integer: Creators the trigger has admitted.
    - `in_progress` integer: Creators still walking it.
    - `sends` integer
    - `reached` integer
    - `gmv` number

## Other responses

- `422`: Validation Error

## Changes

> 76 revisions in range; 1 not diffed.

- **2026-10-20** `9353ed4982e8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/reacherapp/apis/reacher-data-api/changes/workflows/list/post.md)

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) - [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/reacherapp/apis/reacher-data-api/revisions/63ce74b30b5a?raw)