List Messages - Agntix

Every endpoint on this page requires either a Clerk-issued JWT (Authorization: Bearer <token>) or an organization API key (x-api-key: pk_…). Anonymous calls return 401 Unauthorized. See Authentication for the full setup.

Returns every utterance — user, assistant, and tool calls if any. This is the source-of-truth for QA reviewers and for re-training extraction prompts.

Don’t poll. Pull-on-event. Receive the session.ended webhook first, persist the summary fields, then fetch the transcript asynchronously and stash it in object storage (S3/GCS) for your reviewer UI.

Code examples

curl "https://api.agntix.ai/api/v1/chat/sessions/$SESSION_ID/messages" \
  -H "x-api-key: $AGNTIX_API_KEY" \
  -H "Accept: application/json"

const sessionId = "4981804c-2658-4893-84ff-9c2fa90fb3c2";

const { data: messages } = await fetch(
  `https://api.agntix.ai/api/v1/chat/sessions/${sessionId}/messages`,
  { headers: { "x-api-key": process.env.AGNTIX_API_KEY } },
).then((r) => r.json());

for (const msg of messages) {
  console.log(`[${msg.role}] ${msg.content}`);
}

import os, requests

session_id = "4981804c-2658-4893-84ff-9c2fa90fb3c2"

result = requests.get(
    f"https://api.agntix.ai/api/v1/chat/sessions/{session_id}/messages",
    headers={"x-api-key": os.environ["AGNTIX_API_KEY"]},
).json()

for msg in result["data"]:
    print(f"[{msg['role']}] {msg['content']}")

Sample response

{
  "data": [
    {
      "id": "msg_01j3m_user",
      "content": "Hi, this is Alex.",
      "role": "USER",
      "createdAt": "2026-04-08T05:00:03.120Z"
    },
    {
      "id": "msg_01j3m_assistant",
      "content": "Hello Alex, I'm calling about your order #88291. Is now a good time?",
      "role": "ASSISTANT",
      "createdAt": "2026-04-08T05:00:04.001Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 2,
    "totalPages": 1
  }
}