---
title: "GET /v1/workspaces/{workspaceId}/journeys/{journeyId}/people"
method: GET
path: "/v1/workspaces/{workspaceId}/journeys/{journeyId}/people"
---

# GET /v1/workspaces/{workspaceId}/journeys/{journeyId}/people

`GET /v1/workspaces/{workspaceId}/journeys/{journeyId}/people`

## Request

- Base URL: `https://api.bangermail.com`
- URL: `https://api.bangermail.com/v1/workspaces/{workspaceId}/journeys/{journeyId}/people`
- Auth: HTTP bearer

## Query parameters

- `cursor` string
- `limit` integer
- `state` 'in_progress' | 'finished' | 'goal_reached' | 'exited' | 'failed'
- `query` string
- `step_id` string, uuid
- `at` 'now' | 'received'

## Response `200`

The people in the Journey, newest entry first, with each email step's outcome.

- object
  - `data` JourneyPeoplePage, required
    - `steps` object, required: Keyed by step id, for every step anyone has reached.
    - `emails` object[], required
      - `step_id` string, uuid, required
      - `name` string, required
      - `subject` string, required
      - `split_step_id` string, uuid
      - `arm_key` string
    - `counts` object, required
      - `all` integer, required
      - `in_progress` integer, required
      - `finished` integer, required
      - `goal_reached` integer, required
      - `exited` integer, required
      - `failed` integer, required
    - `people` JourneyPerson[], required
      - `enrollment_id` string, uuid, required
      - `contact_id` string, uuid, required
      - `email` string, required
      - `display_name` string, required
      - `state` 'in_progress' | 'finished' | 'goal_reached' | 'exited' | 'failed', required
      - `stop_reason` string
      - `error_code` string
      - `current_step` object
        - `id` string, uuid, required
        - `name` string, required
        - `kind` string, required
      - `next_action_at` string, date-time
      - `enrolled_at` string, date-time, required
      - `completed_at` string, date-time
      - `paths` object, required
      - `emails` object, required: Keyed by email step id. A step with no entry has not been reached.
    - `page` object, required
      - `has_more` boolean, required
      - `next_cursor` string

---

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