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

# Get Conversation Thread — DeltaLead REST API Reference

> Get a conversation by ID with its full message history, channel metadata, and AI-generated summary of key signals and advisor action items.

Fetch a single conversation by its unique identifier to get the complete message thread, channel metadata, and the AI-generated summary that DeltaLead produces after each interaction. Use this endpoint to embed conversation history inside your CRM records, audit AI responses, or display the full context to a sales advisor before they take over from the AI agent.

## Endpoint

```text theme={null}
GET https://platform-api.deltalead.ai/v1/conversations/{id}
```

## Path Parameters

<ParamField path="id" type="string" required>
  The unique identifier of the conversation to retrieve, e.g. `conv_xyz789`. You can obtain conversation IDs from the [List Conversations](/en/api-reference/conversations/list) endpoint or from webhook payloads.
</ParamField>

## Example Request

```bash cURL theme={null}
curl https://platform-api.deltalead.ai/v1/conversations/conv_xyz789 \
  -H "X-API-Key: YOUR_API_KEY"
```

## Response

A successful request returns HTTP `200 OK` with the conversation object, a nested `messages` array containing the full message history, and an `ai_summary` field.

```json 200 OK theme={null}
{
  "id": "conv_xyz789",
  "lead_id": "lead_abc123",
  "channel": "whatsapp",
  "status": "transferred",
  "created_at": "2024-03-10T14:22:05Z",
  "updated_at": "2024-03-11T09:05:33Z",
  "last_message_at": "2024-03-11T09:05:33Z",
  "ai_summary": "Lead is highly interested in the Toyota Hilux SRX 2024 in black. Confirmed budget around US$45,000. Requested financing options and a test drive for this week. Conversation transferred to human advisor for follow-up on financing.",
  "messages": [
    {
      "id": "msg_001",
      "conversation_id": "conv_xyz789",
      "direction": "inbound",
      "type": "text",
      "content": "Hola! Vi la Hilux SRX 2024 que tienen publicada, ¿sigue disponible en negro?",
      "sent_by": "lead",
      "created_at": "2024-03-10T14:22:05Z"
    },
    {
      "id": "msg_002",
      "conversation_id": "conv_xyz789",
      "direction": "outbound",
      "type": "text",
      "content": "¡Hola María! 👋 Sí, la Hilux SRX 2024 en negro sigue disponible. ¿Querés que te cuente las opciones de financiación o preferís coordinar un test drive?",
      "sent_by": "ai_agent",
      "created_at": "2024-03-10T14:22:13Z"
    },
    {
      "id": "msg_003",
      "conversation_id": "conv_xyz789",
      "direction": "inbound",
      "type": "text",
      "content": "Me interesa la financiación, tengo un presupuesto de unos 45000 dólares.",
      "sent_by": "lead",
      "created_at": "2024-03-10T14:25:40Z"
    },
    {
      "id": "msg_004",
      "conversation_id": "conv_xyz789",
      "direction": "outbound",
      "type": "text",
      "content": "Perfecto, María. Para darte las mejores opciones de financiación te voy a conectar con uno de nuestros asesores. Te contactan en breve. 🙌",
      "sent_by": "ai_agent",
      "created_at": "2024-03-10T14:25:48Z"
    }
  ]
}
```

### Response Fields

<ResponseField name="id" type="string">
  Unique identifier of the conversation, prefixed with `conv_`.
</ResponseField>

<ResponseField name="lead_id" type="string">
  ID of the lead this conversation belongs to.
</ResponseField>

<ResponseField name="channel" type="string">
  Channel on which the conversation occurred. One of `whatsapp`, `facebook`, `instagram`, `email`, `phone`.
</ResponseField>

<ResponseField name="status" type="string">
  Current status: `open`, `closed`, or `transferred`.
</ResponseField>

<ResponseField name="ai_summary" type="string">
  AI-generated plain-text summary of the conversation. Updated after each AI turn. Highlights vehicle interest, budget, urgency signals, and any action items for the sales team.
</ResponseField>

<ResponseField name="messages" type="array">
  Ordered array of message objects, from oldest to newest.

  <Expandable title="Message object fields">
    <ResponseField name="id" type="string">
      Unique identifier of the message, prefixed with `msg_`.
    </ResponseField>

    <ResponseField name="conversation_id" type="string">
      ID of the conversation this message belongs to.
    </ResponseField>

    <ResponseField name="direction" type="string">
      `inbound` for messages sent by the lead; `outbound` for messages sent by DeltaLead (AI agent or human advisor).
    </ResponseField>

    <ResponseField name="type" type="string">
      Media type of the message. One of `text`, `audio`, `image`, `document`.
    </ResponseField>

    <ResponseField name="content" type="string">
      Text body of the message. For `audio`, `image`, and `document` types, this field contains a URL to the media file.
    </ResponseField>

    <ResponseField name="sent_by" type="string">
      Who originated this message. One of `ai_agent`, `human`, `lead`.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of when the message was sent or received.
    </ResponseField>
  </Expandable>
</ResponseField>

<Note>
  Phone conversations use a `transcript` field instead of a `messages` array. The `transcript` is a structured text block generated from the call recording and contains speaker labels (e.g., `Agent:` / `Lead:`), timestamps, and the full dialogue. All other conversation fields remain identical.
</Note>