Skip to main content
GET
/
v1
/
conversations
/
{conversationUrn}
Get Conversation by URN
curl --request GET \
  --url https://app-api.walead.ai/api/v1/conversations/{conversationUrn} \
  --header 'x-api-key: <api-key>'
{
  "conversationUrn": "<string>",
  "lead": {},
  "messages": [
    {
      "id": "<string>",
      "content": "<string>",
      "sender": "lead",
      "sentAt": "2023-11-07T05:31:56Z"
    }
  ],
  "campaignId": "<string>"
}

​
Overview

Retrieves a single conversation with all its messages. Use this endpoint to show the full conversation history for a specific lead.

​
Conversation URN

The conversationUrn is a unique identifier for each conversation. You can get this ID from the Get Conversations endpoint.

​
Response

Returns complete conversation details including:
  • Full lead information
  • Complete message history
  • Message sender (lead or your account)
  • Timestamps for each message
  • Associated campaign information

​
Use Cases

  • Display full conversation thread in a custom interface
  • Export conversation history
  • Analyze message patterns
  • Build custom conversation management tools

Authorizations

​
x-api-key
string
header
required

API key for authentication. Generate from your WaLead dashboard.

Path Parameters

​
conversationUrn
string
required

Conversation URN identifier

Response

Conversation retrieved successfully

​
conversationUrn
string

Unique conversation identifier

​
lead
object

Lead information

​
messages
object[]

Array of messages in the conversation

​
campaignId
string

Associated campaign ID