Lead Detail

Get detailed information about a specific lead, including the linked conversation summary.

GET /v1/leads/:id

Path Parameters

Parameter	Type	Description
id	string	The lead ID (UUID)

Response

{
  "data": {
    "id": "880e8400-e29b-41d4-a716-446655440000",
    "email": "[e-mail]",
    "name": "John Doe",
    "phone": "[phone]",
    "source": "chat",
    "conversation_id": "770e8400-e29b-41d4-a716-446655440000",
    "conversation": {
      "id": "770e8400-e29b-41d4-a716-446655440000",
      "title": "Booking inquiry",
      "platform": "webchat",
      "language": "en",
      "created_at": "2026-03-10T09:15:00.000Z"
    },
    "created_at": "2026-03-10T09:20:00.000Z"
  }
}

Response Fields

Field	Type	Description
id	string	Lead ID
email	string|null	Guest email address
name	string|null	Guest name
phone	string|null	Guest phone number
source	string	Channel where the lead was captured
conversation_id	string	ID of the linked conversation
conversation	object|null	Summary of the linked conversation
created_at	string	When the lead was captured

Conversation Object

Field	Type	Description
id	string	Conversation ID
title	string|null	Conversation title
platform	string	Source platform
language	string|null	Conversation language
created_at	string	Conversation start time

Errors

Status	Error	Description
404	Lead not found	ID doesn't exist or belongs to another company

Example

cURL

curl "https://api.opally.com/v1/leads/880e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer op_live_your_api_key_here"

JavaScript