Get Conversation

GET /external/v1/conversations/:id

Retrieves a single conversation together with its messages — the full question/answer trail of the AI qualification and human follow-up.

Authentication

Requires conversations:read permission.

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	The unique identifier of the conversation

Query Parameters

Parameter	Type	Default	Description
messages_limit	integer	200	Maximum number of messages to return (1-500)

Request

cURL

curl --request GET \
  --url "https://app.getraze.com/external/v1/conversations/conv_88?messages_limit=200" \
  --header "X-API-Key: YOUR_API_KEY"

Node.js

const axios = require('axios');

const conversationId = 'conv_88';

const response = await axios.get(
  `https://app.getraze.com/external/v1/conversations/${conversationId}`,
  { headers: { 'X-API-Key': 'YOUR_API_KEY' }, params: { messages_limit: 200 } }
);

console.log(response.data);

Python

import requests

conversation_id = 'conv_88'

response = requests.get(
    f'https://app.getraze.com/external/v1/conversations/{conversation_id}',
    headers={'X-API-Key': 'YOUR_API_KEY'},
    params={'messages_limit': 200}
)

print(response.json())

Response

{
  "success": true,
  "data": {
    "id": "conv_88",
    "status": "active",
    "channel": "LINKEDIN",
    "contact_id": "cnt_abc123",
    "opportunity_id": "opp_abc123",
    "qualification_score": 85,
    "qualification_stage": "qualified",
    "qualification_reasons": ["budget_ok", "decision_maker"],
    "objections_history": [],
    "contact_name": "John Doe",
    "ai_agent_name": "Qualifier Bot",
    "assigned_user_name": "Maria Silva",
    "last_message_at": "2026-01-20T14:00:00Z",
    "created_at": "2026-01-15T10:30:00Z",
    "messages": [
      {
        "id": "msg_1",
        "sender_type": "ai",
        "content": "Hi John, what is your monthly budget?",
        "channel": "LINKEDIN",
        "sent_at": "2026-01-15T10:31:00Z",
        "read_at": "2026-01-15T10:35:00Z",
        "created_at": "2026-01-15T10:31:00Z"
      },
      {
        "id": "msg_2",
        "sender_type": "lead",
        "content": "Around 5k/month.",
        "channel": "LINKEDIN",
        "sent_at": "2026-01-15T10:40:00Z",
        "read_at": null,
        "created_at": "2026-01-15T10:40:00Z"
      }
    ]
  }
}

Response Fields

The conversation object carries the same fields as List Conversations, plus a messages array.

Message object

Field	Type	Description
id	string	Message identifier
sender_type	string	Who sent it: lead, ai or user
content	string	Message text
channel	string	Channel the message was sent through
sent_at	string	ISO 8601 send timestamp
read_at	string	ISO 8601 read timestamp (nullable)
created_at	string	ISO 8601 creation timestamp

Errors

Status	Code	Description
404	NOT_FOUND	Conversation with this ID was not found