GET

Get Conversation

Retrieves a single conversation by id.

GEThttps://api.vantaxai.com/v1/conversations/{conversation_id}

Returns the full conversation record including its status, tags, metadata, and unread counter. Fetch the thread's messages via the Messages API.

Headers

Authorizationstringrequired
Bearer authentication with your secret API key.
example: Bearer vx_live_3fa9c2…

Path Parameters

conversation_idstringrequired
The conversation's unique identifier.
example: conv_7b2e9a

Request

curl -X GET https://api.vantaxai.com/v1/conversations/conv_7b2e9a \
  -H "Authorization: Bearer vx_live_3fa9c2..."

const res = await fetch(
  "https://api.vantaxai.com/v1/conversations/conv_7b2e9a",
  {
  method: "GET",
  headers: {
    Authorization: "Bearer vx_live_3fa9c2...",
  },
  }
);
const { data } = await res.json();

import { Vantax } from "@vantax/sdk";

const vantax = new Vantax({ apiKey: process.env.VANTAX_API_KEY! });
// GET /v1/conversations/{conversation_id}
const result = await vantax.request("GET", "/v1/conversations/{conversation_id}");

from vantax import Vantax

vantax = Vantax(api_key=os.environ["VANTAX_API_KEY"])
# GET /v1/conversations/{conversation_id}
result = vantax.request("GET", "/v1/conversations/{conversation_id}")

Response

{
  "success": true,
  "data": {
    "id": "conv_7b2e9a",
    "sub_account_id": "sub_8a1f4c2e",
    "channel": "whatsapp",
    "contact_id": "ct_19f3a0",
    "status": "open",
    "tags": ["vip", "billing"],
    "metadata": {
      "source": "campaign_spring_2026",
      "priority": "high"
    },
    "unread_count": 2,
    "last_message_at": "2026-06-10T11:42:00Z",
    "created_at": "2026-06-08T09:15:00Z"
  }
}

{
  "success": false,
  "message": "Conversation not found"
}