GET

List Messages in Conversation

Returns a paginated list of messages belonging to a conversation, oldest-first.

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

Messages are returned in chronological order (oldest-first) so they read like a transcript. Each message records the `channel` it was sent on, its `direction` (inbound from the contact or outbound from your Agent), and a delivery `status`. Use the `limit` and `starting_after` cursor parameters to page through long threads.

Headers

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

Path Parameters

conversation_idstringrequired
The conversation whose messages you want to list.
example: conv_4b8e21

Query Parameters

limitintegeroptional
Number of records to return (1–100). Defaults to 50.
example: 50
starting_afterstringoptional
Cursor for pagination — a message id to start after.
example: msg_7c1a09

Request

curl https://api.vantaxai.com/v1/conversations/conv_4b8e21/messages?limit=50 \
  -H "Authorization: Bearer vx_live_3fa9c2..."

const res = await fetch(
  "https://api.vantaxai.com/v1/conversations/conv_4b8e21/messages?limit=50",
  { headers: { Authorization: "Bearer vx_live_3fa9c2..." } }
);
const { data: messages } = await res.json();

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

const vantax = new Vantax({ apiKey: process.env.VANTAX_API_KEY! });
const messages = await vantax.messages.list({
  conversationId: "conv_4b8e21",
  limit: 50,
});

from vantax import Vantax

vantax = Vantax(api_key=os.environ["VANTAX_API_KEY"])
messages = vantax.messages.list(conversation_id="conv_4b8e21", limit=50)

Response

{
  "success": true,
  "data": [
    {
      "id": "msg_7c1a09",
      "conversation_id": "conv_4b8e21",
      "channel": "sms",
      "direction": "inbound",
      "content": "Hi, are you open this Saturday?",
      "subject": null,
      "sender_type": "contact",
      "media_url": [],
      "status": "delivered",
      "created_at": "2026-01-14T10:30:00Z"
    },
    {
      "id": "msg_7c1a4f",
      "conversation_id": "conv_4b8e21",
      "channel": "sms",
      "direction": "outbound",
      "content": "Yes! We're open Saturday 9am–4pm. Would you like to book a slot?",
      "subject": null,
      "sender_type": "ai",
      "media_url": [],
      "status": "sent",
      "created_at": "2026-01-14T10:30:12Z"
    }
  ],
  "pagination": {
    "total": 2,
    "limit": 50,
    "has_more": false
  }
}

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