> ## Documentation Index
> Fetch the complete documentation index at: https://api.smartlead.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Lead Sequence Details

> Get the send status of every sequence step for a lead in a campaign

<Note>
  Returns one entry per email stats row for the lead map, in all statuses (for example `SENT` and `STOPPED`), ordered by `sent_time`. Get `leadMapId` from [Get Lead Campaign Overview](/api-reference/leads/campaign-overview) (`id`) or `campaign_lead_map_id` from the campaign's leads.
</Note>

## Path Parameters

<ParamField path="leadMapId" type="number" required>
  Lead map ID (positive integer)
</ParamField>

## Query Parameters

<ParamField query="api_key" type="string" required>
  Your SmartLead API key (client API keys are not allowed)
</ParamField>

<ParamField query="campaignId" type="number">
  Campaign ID to restrict the results to (positive integer)
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://server.smartlead.ai/api/v1/leads/987654/sequence-details?api_key=YOUR_KEY&campaignId=123"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://server.smartlead.ai/api/v1/leads/987654/sequence-details",
      params={"api_key": "YOUR_API_KEY", "campaignId": 123}
  )
  for step in response.json()["data"]:
      print(step["email_campaign_seq_id"], step["status"])
  ```
</RequestExample>

## Response

<ResponseField name="data" type="array">
  <Expandable title="items">
    <ResponseField name="status" type="string">Send status of the step</ResponseField>
    <ResponseField name="sent_time" type="string | null">When the step was sent</ResponseField>
    <ResponseField name="status_message" type="string | null">Status message</ResponseField>
    <ResponseField name="email_campaign_seq_id" type="number">Sequence ID</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "ok": true,
    "message": "Lead sequence details fetched successfully",
    "data": [
      {
        "status": "SENT",
        "sent_time": "2026-09-20T09:00:00.000Z",
        "status_message": null,
        "email_campaign_seq_id": 5001
      },
      {
        "status": "STOPPED",
        "sent_time": null,
        "status_message": null,
        "email_campaign_seq_id": 5002
      }
    ]
  }
  ```

  ```json 500 theme={null}
  {
    "ok": false,
    "message": "Error fetching lead sequence details"
  }
  ```
</ResponseExample>
