GET

Get Call

Retrieves the full record of a single call, including transcript, recording, and AI analysis.

GEThttps://api.vantaxai.com/v1/calls/{call_id}

Returns everything the Agent captured for the call: the turn-by-turn `transcript` (each entry tagged `agent` or `caller` with a timestamp), the `recording_url`, an `ai_summary`, the detected `outcome` and caller `sentiment`, total `duration`, any `tool_calls` the Agent executed mid-call (e.g. checking the calendar or booking an appointment), and the `call_end_reason` describing how the call wrapped up.

Headers

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

Path Parameters

call_idstringrequired
The call's unique identifier.
example: call_7f3a9c21

Request

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

const res = await fetch(
  "https://api.vantaxai.com/v1/calls/call_7f3a9c21",
  {
  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/calls/{call_id}
const result = await vantax.request("GET", "/v1/calls/{call_id}");

from vantax import Vantax

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

Response

{
  "success": true,
  "data": {
    "id": "call_7f3a9c21",
    "sub_account_id": "sub_8a1f4c2e",
    "agent_id": "agt_3d9b21",
    "contact_id": "ct_9d12fa",
    "direction": "inbound",
    "status": "completed",
    "from": "+14155550142",
    "to": "+18885550199",
    "duration": 184,
    "recording_url": "https://cdn.vantaxai.com/recordings/call_7f3a9c21.mp3",
    "ai_summary": "Caller asked about weekend availability for a deep clean. Agent confirmed a Saturday 2:00 PM slot, booked the appointment, and texted a confirmation.",
    "outcome": "appointment_booked",
    "sentiment": "positive",
    "call_end_reason": "caller_hangup",
    "transcript": [
      {
        "role": "agent",
        "text": "Thanks for calling Sparkle Home Cleaning, this is Aria. How can I help you today?",
        "timestamp": "2026-06-09T15:42:11Z"
      },
      {
        "role": "caller",
        "text": "Hi, do you have anything open this Saturday for a deep clean?",
        "timestamp": "2026-06-09T15:42:18Z"
      },
      {
        "role": "agent",
        "text": "Let me check the calendar for Saturday — one moment.",
        "timestamp": "2026-06-09T15:42:23Z"
      },
      {
        "role": "agent",
        "text": "I have a 2:00 PM slot open on Saturday the 13th. Would you like me to book that for you?",
        "timestamp": "2026-06-09T15:42:31Z"
      },
      {
        "role": "caller",
        "text": "Yes, 2 PM works great.",
        "timestamp": "2026-06-09T15:42:38Z"
      },
      {
        "role": "agent",
        "text": "All set! You're booked for Saturday at 2:00 PM. I'll text a confirmation to this number. Anything else?",
        "timestamp": "2026-06-09T15:42:52Z"
      },
      {
        "role": "caller",
        "text": "Nope, that's everything. Thank you!",
        "timestamp": "2026-06-09T15:43:01Z"
      }
    ],
    "tool_calls": [
      {
        "name": "check_calendar_availability",
        "arguments": { "calendar_id": "cal_22f9", "date": "2026-06-13" },
        "output": "{\"slots\":[\"14:00\",\"16:30\"]}",
        "error": false
      },
      {
        "name": "book_appointment",
        "arguments": {
          "calendar_id": "cal_22f9",
          "contact_id": "ct_9d12fa",
          "start": "2026-06-13T14:00:00Z",
          "service": "Deep Clean"
        },
        "output": "{\"appointment_id\":\"appt_5c7d10\",\"status\":\"confirmed\"}",
        "error": false
      }
    ],
    "created_at": "2026-06-09T15:42:10Z"
  }
}

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