---
title: "Get Sequence Step Occupancy"
method: GET
path: "/api/sequences/{sequence_id}/step-occupancy"
tags: ["sequences"]
---

# Get Sequence Step Occupancy

`GET /api/sequences/{sequence_id}/step-occupancy`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/sequences/{sequence_id}/step-occupancy`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

How many people currently sit at each step of the sequence.

One aggregated read over runtime instances: per-node counts for everyone
still in the graph plus completed/failed totals for everyone who left it.
Node ids match the workflow node ids the builder renders.

## Path parameters

- `sequence_id` string, required

## Response `200`

Successful Response

- SequenceStepOccupancyPayload: Current recipient occupancy across a campaign workflow.
  - `completed_count` integer, required: People whose campaign runtime completed.
  - `failed_count` integer, required: People whose latest runtime state is failed.
  - `nodes` SequenceStepOccupancyNodePayload[], required: Per-node active recipient counts.
    - `active_count` integer, required: People whose current runtime position is this node.
    - `node_id` string, required: Workflow node id.
  - `published_revision_id` string, nullable, required: Published revision used by the counted runtime instances.
  - `sequence_id` string, required: Campaign whose runtime occupancy was counted.
  - `total_active` integer, required: People with active campaign runtime instances.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)