VoxLink.ai
Start Free

API Reference

List calls

List all calls for the authenticated user with filtering options

On this page

This endpoint allows you to list all calls belonging to the authenticated user with various filtering options.

Query Parameters

statusstring

Filter calls by status. Possible values: initiated, ringing, busy, in-progress, ended, completed, ended_by_customer, ended_by_assistant, no-answer, failed

typestring

Filter calls by type. Possible values: inbound, outbound, web

phone_numberstring

Filter calls by client phone number

assistant_idinteger

Filter calls by assistant ID

campaign_idinteger

Filter calls by campaign ID

date_fromstring

Filter calls from this date (YYYY-MM-DD format)

date_tostring

Filter calls until this date (YYYY-MM-DD format)

per_pageinteger

Number of calls per page (1-100, default: 15)

pageinteger

Page number (default: 1)

Response fields

dataarray

idinteger

  The unique identifier of the call

assistant_namestring

  The name of the assistant that handled the call

campaign_namestring

  The name of the campaign this call belongs to (if applicable)

typestring

  The type of the call (`inbound`, `outbound`, or `web`)

durationinteger

  The duration of the call in seconds

assistant_phone_numberstring

  The phone number used by the assistant

client_phone_numberstring

  The phone number of the client

statusstring

  The current status of the call

transcriptstring

  The transcript of the call conversation

variablesobject

  Variables collected during the call

evaluationobject

  Evaluation data for the call performance

webhook_responseobject

  Response from any configured webhooks

carrier_costnumber

  The cost charged by the carrier for this call

total_costnumber

  The total cost of the call including all fees

answered_bystring

  Who answered the call (`human`, `machine`, or `unknown`)

recording_urlstring

  URL to the call recording (if available and enabled)

created_atstring

  The date and time when the call was created

updated_atstring

  The date and time when the call was last updated

current_pageinteger

The current page number

per_pageinteger

Number of items per page

totalinteger

Total number of calls matching the criteria

last_pageinteger

The last page number

{
  "current_page": 1,
  "data": [
    {
      "id": 123,
      "assistant_name": "Sales Assistant",
      "campaign_name": "Q4 Outreach Campaign",
      "type": "outbound",
      "duration": 245,
      "assistant_phone_number": "+1234567890",
      "client_phone_number": "+1987654321",
      "status": "completed",
      "transcript": "Hello, this is Sarah from VoxLink. How are you doing today?...",
      "variables": {
        "customer_name": "John Smith",
        "interest_level": "high",
        "follow_up_date": "2025-08-15"
      },
      "evaluation": {
        "sentiment": "positive",
        "outcome": "qualified_lead",
        "score": 8.5
      },
      "webhook_response": {
        "status": "success",
        "data": {
          "crm_contact_id": "abc123"
        }
      },
      "carrier_cost": 0.02,
      "total_cost": 0.025,
      "answered_by": "human",
      "recording_url": "https://recordings.voxlink.ai/calls/123.mp3",
      "created_at": "2025-08-04 14:30:00",
      "updated_at": "2025-08-04 14:34:05"
    }
  ],
  "first_page_url": "https://app.voxlink.ai/api/user/calls?page=1",
  "from": 1,
  "last_page": 10,
  "last_page_url": "https://app.voxlink.ai/api/user/calls?page=10",
  "links": [
    {
      "url": null,
      "label": "« Previous",
      "active": false
    },
    {
      "url": "https://app.voxlink.ai/api/user/calls?page=1",
      "label": "1",
      "active": true
    },
    {
      "url": "https://app.voxlink.ai/api/user/calls?page=2",
      "label": "2",
      "active": false
    }
  ],
  "next_page_url": "https://app.voxlink.ai/api/user/calls?page=2",
  "path": "https://app.voxlink.ai/api/user/calls",
  "per_page": 15,
  "prev_page_url": null,
  "to": 15,
  "total": 150
}

Related guides

API Reference

Introduction

Welcome to the VoxLink API

Read guide →

API Reference

Authentication

Learn how to authenticate your API requests

Read guide →

API Reference

Get current user

Get the authenticated user's profile information

Read guide →

API Reference

List assistants

List all assistants for the authenticated user with pagination

Read guide →