GET

List Call History

Returns a paginated list of calls — inbound and outbound — for a sub-account.

GEThttps://api.vantaxai.com/v1/calls

Calls are returned newest-first (by start time). Filter by `direction`, `status`, or `agent_id`, narrow to a window with `start_date` / `end_date`, or `search` across phone numbers, contact names, transcripts, and AI summaries. Use `page` and `limit` to page through large collections.

Headers

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

Query Parameters

sub_account_idstringrequired
The sub-account to list calls for.
example: sub_8a1f4c2e
pageintegeroptional
1-based page number. Defaults to 1.
example: 1
limitintegeroptional
Number of records per page (1–100). Defaults to 20.
example: 20
directionstringoptional
Filter by call direction.
inboundoutbound
example: inbound
statusstringoptional
Filter by call status.
initiatedringingin_progresscompletedfailedno_answerbusy
example: completed
agent_idstringoptional
Only return calls handled by this Agent.
example: agt_3d9b21
searchstringoptional
Free-text search across phone numbers, contact name/email, transcript, and AI summary.
example: refund
start_datestringoptional
Only return calls started at or after this ISO-8601 timestamp.
example: 2026-06-01T00:00:00Z
end_datestringoptional
Only return calls started at or before this ISO-8601 timestamp.
example: 2026-06-10T23:59:59Z

Request

curl "https://api.vantaxai.com/v1/calls?sub_account_id=sub_8a1f4c2e&direction=inbound&status=completed&limit=20" \
  -H "Authorization: Bearer vx_live_3fa9c2..."

const params = new URLSearchParams({
  sub_account_id: "sub_8a1f4c2e",
  direction: "inbound",
  status: "completed",
  limit: "20",
});
const res = await fetch(`https://api.vantaxai.com/v1/calls?${params}`, {
  headers: { Authorization: "Bearer vx_live_3fa9c2..." },
});
const { data: calls, pagination } = await res.json();

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

const vantax = new Vantax({ apiKey: process.env.VANTAX_API_KEY! });
const calls = await vantax.calls.list({
  subAccountId: "sub_8a1f4c2e",
  direction: "inbound",
  status: "completed",
  limit: 20,
});

from vantax import Vantax

vantax = Vantax(api_key=os.environ["VANTAX_API_KEY"])
calls = vantax.calls.list(
    sub_account_id="sub_8a1f4c2e",
    direction="inbound",
    status="completed",
    limit=20,
)

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 Saturday availability and booked a 2pm cleaning.",
      "outcome": "appointment_booked",
      "created_at": "2026-06-09T15:42:10Z"
    },
    {
      "id": "call_2b81e004",
      "sub_account_id": "sub_8a1f4c2e",
      "agent_id": "agt_3d9b21",
      "contact_id": "ct_44ee07",
      "direction": "outbound",
      "status": "no_answer",
      "from": "+18885550199",
      "to": "+14155550188",
      "duration": 0,
      "recording_url": null,
      "ai_summary": null,
      "outcome": "no_answer",
      "created_at": "2026-06-09T14:05:51Z"
    }
  ],
  "pagination": {
    "total": 218,
    "page": 1,
    "limit": 20,
    "has_more": true
  }
}

{
  "success": false,
  "message": "Validation failed",
  "errors": [
    { "field": "sub_account_id", "message": "sub_account_id is required" }
  ]
}