---
title: "Per-step workflow counts"
method: GET
path: "/workflows/{workflow_id}/step-stats"
tags: ["Workflows"]
---

# Per-step workflow counts

`GET /workflows/{workflow_id}/step-stats`

## Request

- Base URL: `https://api.reacherapp.com/public/v1`
- URL: `https://api.reacherapp.com/public/v1/workflows/{workflow_id}/step-stats`
- Auth: API key in header `x-api-key` and API key in header `x-shop-id`

How many creators entered, completed, are waiting at, were sent from, or were skipped at each step, plus branch counts for Condition steps (`true_count` / `false_count`), `timed_out` for Wait Until, and A/B arm counts for a split step. `triggered` is how many the trigger has admitted in total.

## Path parameters

- `workflow_id` string, required: The workflow's uuid, as `POST /workflows/list` returns it.

## Response `200`

Successful Response

- EnvelopeWorkflowStepStatsPublic
  - `data` WorkflowStepStatsPublic, required
    - `workflow_id` string, required
    - `triggered` integer, required: Creators the trigger has admitted in total.
    - `steps` WorkflowStepStatsRowPublic[], required
      - `step_id` string, required
      - `entered` integer, required
      - `completed` integer, required
      - `waiting` integer, required
      - `sent` integer
      - `skipped` integer
      - `true_count` integer: Condition step: took the Yes branch.
      - `false_count` integer: Condition step: took the No branch.
      - `timed_out` integer: Wait Until: the timeout elapsed first.
      - `variant_a` integer
      - `variant_b` integer

## Other responses

- `404`: No such workflow in this shop.
- `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/:workflow_id/step-stats/get.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)