---
title: "Get Lead"
method: GET
path: "/v1/lead/{lead_id}"
tags: ["lead"]
---

# Get Lead

`GET /v1/lead/{lead_id}`

## Path parameters

- `lead_id` string, uuid, required

## Query parameters

- `include_feedback` boolean — Include message feedback data in the response

## Response `200`

Successful Response

- LeadResponse
  - `IsActive` boolean, required
  - `Classification` string, required
  - `ConversationHistory` Message[], required
    - `MessageId` string, uuid, nullable
    - `Content` string, nullable, required
    - `Inbound` boolean, required
    - `Timestamp` string, date-time, required
    - `IsDeleted` boolean, nullable
    - `ExternalMessageId` string, nullable
    - `Status` 'sending' | 'sent' | 'delivered' | 'read' | 'failed' | 'deleted' | 'played'
    - `StatusError` string, nullable
    - `Feedback` MessageFeedback
      - `FeedbackContent` string, required
      - `isSatisfactory` boolean, required
    - `Type` string, nullable
    - `SentBy` string, nullable
    - `Buttons` object[], nullable
    - `QuickReplies` object[], nullable
    - `MediaType` string, nullable
    - `AudioUrl` string, nullable
    - `ScheduledMessageID` string, nullable
    - `PendingApproval` boolean, nullable
    - `ContentUnavailable` boolean, nullable
  - `UpcomingMessages` Message[], required
    - `MessageId` string, uuid, nullable
    - `Content` string, nullable, required
    - `Inbound` boolean, required
    - `Timestamp` string, date-time, required
    - `IsDeleted` boolean, nullable
    - `ExternalMessageId` string, nullable
    - `Status` 'sending' | 'sent' | 'delivered' | 'read' | 'failed' | 'deleted' | 'played'
    - `StatusError` string, nullable
    - `Feedback` MessageFeedback
      - `FeedbackContent` string, required
      - `isSatisfactory` boolean, required
    - `Type` string, nullable
    - `SentBy` string, nullable
    - `Buttons` object[], nullable
    - `QuickReplies` object[], nullable
    - `MediaType` string, nullable
    - `AudioUrl` string, nullable
    - `ScheduledMessageID` string, nullable
    - `PendingApproval` boolean, nullable
    - `ContentUnavailable` boolean, nullable
  - `LeadInformation` LeadInformation, required
    - `LeadID` string, required
    - `FirstName` string, required
    - `LastName` string, nullable, required
    - `PhoneNumber` string, required
    - `CreatedAt` string, date-time, required
    - `LeadIntegration` string, required
    - `OrgId` string, required
    - `ProfilePictureURL` string, nullable
    - `Username` string, nullable
    - `BusinessWhatsappPhoneNumber` string, nullable
    - `BusinessInstagramUsername` string, nullable
    - `AssignedToUserId` string, nullable
    - `IsPersonalWhatsapp` boolean
  - `Channel` string, required
  - `TriggerDetails` TriggerDetailsResponse, required
    - `TriggerType` 'CONTACT_CREATED' | 'CONTACT_SUBSCRIBED_TO_SEQUENCE' | 'WHATSAPP_MESSAGE' | 'INSTAGRAM_COMMENT' | 'INSTAGRAM_MESSAGE' | 'INSTAGRAM_STORY_REPLY' | 'INSTAGRAM_LEAD_FINDER_NEW_FOLLOWER' | 'INSTAGRAM_LEAD_FINDER_OTHER_ACCOUNT_FOLLOWERS' | 'INSTAGRAM_LEAD_FINDER_NEW_LIKE' | 'INSTAGRAM_LEAD_FINDER_OTHER_ACCOUNT_COMMENT', required
    - `TextContent` string, nullable, required
    - `ExternalID` string, required
    - `MediaURL` string, nullable, required
    - `ExternalURL` string, nullable, required
    - `SourceMediaId` string, nullable
    - `Timestamp` string, date-time, required
  - `AgentName` string, nullable
  - `SendingBlocked` SendingBlockedInfo — Set when the channel this conversation runs on cannot currently send, so the UI can say it up front instead of showing messages that quietly fail.
    - `Reason` string, required
    - `PhoneNumber` string, nullable
    - `Detail` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/orsay/apis/fastapi.md) · [All operations](https://skmtc.net/orsay/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orsay/fastapi/revisions/23d1ff06d0d0/schema)