---
title: "List sequence leads"
method: GET
path: "/multichannel/workspaces/{workspaceID}/sequences/{sequenceID}/leads"
tags: ["Sequences"]
---

# List sequence leads

`GET /multichannel/workspaces/{workspaceID}/sequences/{sequenceID}/leads`

## Request

- Base URL: `https://multichannel-api.salesforge.ai/public`
- URL: `https://multichannel-api.salesforge.ai/public/multichannel/workspaces/{workspaceID}/sequences/{sequenceID}/leads`
- Auth: API key in header `Authorization`

Returns a page of leads enrolled in the sequence. Each item contains contact details, current enrollment state, and timeline steps in execution order.
Pagination applies to leads, including when filtering by leadIds. Each lead includes its available timeline without separate pagination.
Results default to the most recently updated enrollments. Date filters use inclusive UTC dates and apply to the timestamp selected by sortBy.

## Path parameters

- `workspaceID` string, required
- `sequenceID` integer, required

## Query parameters

- `page` integer
- `limit` integer
- `status` string
- `q` string
- `openedEmailsOnly` boolean
- `in_subsequence` boolean
- `leadIds` string
- `sortBy` 'recently_contacted' | 'least_recently_contacted' | 'recently_updated' | 'recently_added' | 'oldest_added'
- `sortOrder` 'asc' | 'desc'
- `from` string
- `to` string

## Response `200`

OK

- ResponsesSequenceLeadListResponse
  - `leads` ResponsesSequenceLeadProgressResponse[], required
    - `enrollment` ResponsesSequenceLeadEnrollmentResponse, required
      - `inSubsequence` boolean, required
      - `pauseReason` string
      - `status` 'active' | 'paused' | 'completed' | 'failed' | 'replied' | 'out_of_office' | 'unsubscribed' | 'dnc' | 'bounced' | 'bounce-shield' | 'company_limit_reached' | 'stop_on_reply', required
      - `updatedAt` string, date-time, required: UpdatedAt is the last update time of the enrollment record.
    - `lead` ResponsesSequenceLeadResponse, required
      - `email` string, required
      - `firstName` string, required
      - `lastName` string, required
      - `leadId` string, required
      - `linkedinUrl` string, required
      - `position` string
      - `profilePictureUrl` string
    - `timeline` ResponsesSequenceLeadTimelineStepResponse[], required
      - `actionChannel` 'email' | 'linkedin' | 'inmail'
      - `actionName` string
      - `blockedByLeadStatus` string: BlockedByLeadStatus is the enrollment status preventing a pending or scheduled step from running.
      - `branchTaken` string
      - `conditionName` string
      - `content` ResponsesSequenceLeadContentResponse: Stored outbound message content. Use delivery to determine the recorded send outcome.
        - `contentType` 'text/html' | 'text/plain', required: ContentType is inferred from email markup; LinkedIn content is text/plain.
        - `message` string, required
        - `subject` string
      - `delivery` ResponsesSequenceLeadDeliveryResponse: Send and bounce evidence for email, LinkedIn messages, and InMail. Included only for these message actions. LinkedIn sends require a sent message associated with the step.
        - `bouncedAt` string, date-time
        - `channel` 'email' | 'linkedin', required
        - `sentAt` string, date-time: SentAt is the recorded email send time. Omitted for LinkedIn.
        - `status` 'unknown' | 'sent' | 'bounced', required: Status is unknown when no send or bounce is recorded, sent when a send is recorded, or bounced for an email bounce. A recorded send does not confirm receipt or reading.
      - `engagement` ResponsesSequenceLeadEngagementResponse: Recorded email opens and clicks. Zero counts mean no recorded events; tracking availability is unknown. Included when an email send or engagement event is recorded.
        - `clickCount` integer, required: ClickCount is the number of recorded clicks.
        - `lastClickedAt` string, date-time
        - `lastOpenedAt` string, date-time
        - `openCount` integer, required: OpenCount is the number of recorded opens.
      - `error` ResponsesSequenceLeadStepErrorResponse
        - `failedAt` string, date-time, required
        - `message` string, required
        - `retryCount` integer, required
      - `executedAt` string, date-time
      - `executionOrder` integer, required
      - `executionStatus` 'pending' | 'scheduled' | 'processing' | 'completed' | 'failed', required: ExecutionStatus is the processing state of the step. Message outcomes are reported in delivery.
      - `nodeId` integer, required
      - `nodeType` 'action' | 'condition' | 'root' | 'terminal', required
      - `replyContent` ResponsesSequenceLeadReplyContentResponse: The earliest stored reply associated with the step, regardless of current enrollment status. Replies are matched by task; replies without a task association are matched to the latest preceding execution on the same channel. This is a single reply, not the full conversation.
        - `channel` 'email' | 'linkedin', required
        - `contentType` 'text/html' | 'text/plain', required: ContentType is inferred from email markup; LinkedIn content is text/plain.
        - `message` string, required
        - `repliedAt` string, date-time
        - `subject` string
      - `scheduledAt` string, date-time: ScheduledAt is the planned execution time, subject to sequence and sender availability.
      - `sender` ResponsesSequenceLeadSenderResponse: The profile and mailbox assigned to the step. Profile details reflect their current stored values.
        - `email` string, required
        - `linkedinUrl` string, required
        - `mailboxId` string
        - `senderProfileId` integer, required
        - `senderProfileName` string, required
  - `pagination` ResponsesPaginationResponse, required
    - `hasNext` boolean
    - `limit` integer
    - `page` integer
    - `total` integer
    - `totalPages` integer

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/salesforge/apis/multichannel-public-api.md) - [All operations](https://skmtc.dev/salesforge/apis/multichannel-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/salesforge/apis/multichannel-public-api/revisions/f4dc28ed447d?raw)