Sequence Leads

Get sequence leads

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.

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

Path parameters

sequence_idstring required

Encrypted sequence identifier

Example:MLVEUadsfgzdsafsc10q5g%3D%3D!vNnNM

Query parameters

status'active' | 'not_started' | 'pending' | 'finished' | 'deleted'

Status of the lead within the sequence

cursorstring

Cursor for pagination (opaque string from previous response)

Example:eyJpZCI6IjEyMzQ1In0
limitstring

Number of leads to return (1-100, default: 25)

Example:25

Response

Sequence leads retrieved successfully

Example response

{
  "data": [
    {
      "id": "MLVEUwp4gsag4gMsc10q5g%3D%3D!vNnNM",
      "sequence_id": "MLVEUadsfgzdsafsc10q5g%3D%3D!vNnNM",
      "selected_introducers": [
        {
          "linkedin_identifier": "john-doe-123",
          "name": "John Doe",
          "rank": 1,
          "is_direct": false
        }
      ]
    }
  ],
  "pagination": {
    "cursor": "eyJpZCI6IjEyMzQ1In0",
    "has_next_page": true,
    "count": 20
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.