---
title: "Get sequence leads"
method: GET
path: "/v2/sequences/{sequence_id}/leads"
tags: ["Sequence Leads"]
---

# Get sequence leads

`GET /v2/sequences/{sequence_id}/leads`

## Request

- Base URL: `https://api.village.ai`
- URL: `https://api.village.ai/v2/sequences/{sequence_id}/leads`
- Auth: HTTP bearer

List the people (leads) enrolled in a specific sequence — paginated, with optional status filtering. Provide the sequence_id. Use this to see who is in a campaign and each lead's status. Returns a paginated array of leads. When a lead replies, Village finishes the lead automatically (status 'finished', pending drafts deleted, no further sends); the reply's content is not exposed through any tool here — it lives in the user's own mailbox, so read and answer it there. A finished lead can also mean the journey ran out of steps or it was finished by hand.

## Path parameters

- `sequence_id` string, required: Encrypted sequence identifier

## Query parameters

- `status` 'active' | 'not_started' | 'pending' | 'finished' | 'deleted': Status of the lead within the sequence
- `cursor` string: Cursor for pagination (opaque string from previous response)
- `limit` string: Number of leads to return (1-100, default: 25)

## Response `200`

Sequence leads retrieved successfully

- object
  - `data` object[], required
    - `id` string, required: Encrypted lead identifier
    - `sequence_id` string, required: Encrypted sequence identifier
    - `village_person_id` integer, required
    - `status` 'active' | 'not_started' | 'pending' | 'finished' | 'deleted', required: Status of the lead within the sequence
    - `next_followup_at` string, date-time, nullable, required
    - `selected_introducers` object[], nullable, required
      - `linkedin_identifier` string, required
      - `name` string
      - `rank` integer, required
      - `is_direct` boolean
      - `score` number
    - `pipeline_stage` integer, nullable, required
    - `created_at` string, date-time, required
    - `person` object, nullable, required: Person data from PostgreSQL people table for sequences
      - `id` integer, required
      - `first_name` string, nullable, required
      - `last_name` string, nullable, required
      - `full_name` string, nullable, required
      - `linkedin_url` string, uri, nullable, required
      - `linkedin_identifier` string, nullable, required
      - `headline` string, nullable, required
      - `location` object, nullable, required
        - `city` string, nullable, required
        - `state` string, nullable, required
        - `country` string, nullable, required
      - `position` object, nullable, required
        - `title` string, nullable, required
        - `company` object, nullable, required
          - `id` string, nullable, required
          - `name` string, required
          - `linkedin_url` string, uri, nullable, required
          - `domain` string, nullable, required
        - `start_date` string, nullable, required
        - `end_date` string, nullable, required
      - `image_url` string, uri, nullable, required
      - `email` string, email, nullable, required
    - `latest_update` string, nullable, required
    - `latest_update_date` string, date-time, nullable, required
    - `replied` boolean, required
    - `has_next_step` boolean, required
  - `metadata` object, required
    - `request_id` string, required
  - `pagination` PaginationInfo, required: Cursor-based pagination metadata
    - `cursor` string, nullable, required: Opaque cursor for fetching the next page (null if no more results)
    - `has_next_page` boolean, required: Whether more results are available
    - `count` integer, required: Total number of results or count of items in current page

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Unauthorized - missing or invalid authentication
- `404`: Sequence not found

---

[API](https://skmtc.dev/village/apis/village-v2-api.md) - [All operations](https://skmtc.dev/village/apis/village-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/village/apis/village-v2-api/revisions/aebe21a1a544?raw)