List Call Logs

Returns call logs for Voice AI agents scoped to a account. Supports filtering by agent, contact, call type, action types, and date range (interpreted in the provided IANA timezone). Also supports sorting and 1-based pagination.

GET https://services.leadconnectorhq.com/voice-ai/dashboard/call-logs

Autorización

string

required

Bearer token generado desde el portal Leadway. Ver Autenticación.

string

default:"2021-07-28"

required

Versión de la API.

Query parameters

string

required

Account identifier. Filters results to this account.

string

default:"507f1f77bcf86cd799439011"

Agent identifier. When provided, returns logs for this agent only.

string

default:"contact123,contact456"

Contact IDs (comma-separated) to filter by.

string

Call type filter.

number

default:"1679308800000"

Start date filter (Unix timestamp). Must be less than endDate. Both startDate and endDate must be provided together.

number

default:"1679395199000"

End date filter (Unix timestamp). Must be greater than startDate. Both startDate and endDate must be provided together.

string

default:"SMS,CALL_TRANSFER,WORKFLOW_TRIGGER"

Action type filter for call logs (comma-separated ACTION_TYPE values)

string

Field to sort by. Defaults to newest if omitted.

string

Sort direction. Applies only when sortBy is provided.

number

Page number (1-based).

number

Page size (max 50).

Respuestas

200 - Successfully retrieved call logs

number

default:"150"

required

Total number of items

number

default:"2"

required

Page number starting from 1

number

default:"10"

required

Number of items per page

object[]

required

Array of call logs

Show cada item

string

default:"507f1f77bcf86cd799439011"

required

Unique identifier for the call

string

default:"507f1f77bcf86cd799439012"

Associated contact ID

string

default:"507f1f77bcf86cd799439013"

required

Agent ID associated with the call

boolean

default:"False"

required

Whether the agent is deleted

string

default:"+1234567890"

Caller phone number

string

default:"2024-01-15T10:30:00.000Z"

required

Timestamp when the call was created

number

default:"180"

required

Call duration in seconds

boolean

default:"False"

required

Whether this call was a trial call

object[]

required

Actions performed during the call. Note: The APPOINTMENT_BOOKING action will only be visible in executedCallActions from Sep 9th 2025.

Show cada item

string

default:"507f1f77bcf86cd799439015"

Action ID reference

string

default:"SMS"

required

Action type Posibles valores: ‘CALL_TRANSFER’, ‘DATA_EXTRACTION’, ‘IN_CALL_DATA_EXTRACTION’, ‘WORKFLOW_TRIGGER’, ‘SMS’, ‘APPOINTMENT_BOOKING’, ‘CUSTOM_ACTION’, ‘KNOWLEDGE_BASE’

string

default:"Send SMS Confirmation"

required

Action name

object

Action parameters - structure varies by actionType

string

default:"2024-01-15T10:32:00.000Z"

When the action was executed

string

default:"2024-01-15T10:31:45.000Z"

When the trigger was received

string

required

Call summary

string

required

Call transcript

object

Transcript translation details

object

Dynamic data extracted from the call based on agent configuration

string

default:"507f1f77bcf86cd799439014"

Message identifier associated with the call

{
  "total": 150,
  "page": 2,
  "pageSize": 10,
  "callLogs": [
    {
      "id": "507f1f77bcf86cd799439011",
      "contactId": "507f1f77bcf86cd799439012",
      "agentId": "507f1f77bcf86cd799439013",
      "isAgentDeleted": false,
      "fromNumber": "+1234567890",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "duration": 180,
      "trialCall": false,
      "executedCallActions": [
        {
          "actionId": "507f1f77bcf86cd799439015",
          "actionType": "CALL_TRANSFER",
          "actionName": "Transfer to Manager",
          "actionParameters": {
            "transferToType": "number",
            "transferToValue": "+12345678901",
            "triggerMessage": "Let me transfer you to a manager right away",
            "hearWhisperMessage": true
          },
          "executedAt": "2024-01-15T10:32:00.000Z",
          "triggerReceivedAt": "2024-01-15T10:31:45.000Z"
        },
        {
          "actionId": "507f1f77bcf86cd799439016",
          "actionType": "SMS",
          "actionName": "Send Confirmation SMS",
          "actionParameters": {
            "triggerPrompt": "When caller asks for booking confirmation",
            "triggerMessage": "I'll send you a confirmation text",
            "messageBody": "Your appointment is confirmed for tomorrow at 2 PM"
          },
          "executedAt": "2024-01-15T10:33:30.000Z",
          "triggerReceivedAt": "2024-01-15T10:33:15.000Z"
  // truncado: 131 lineas mas
}

400 - Bad Request

{}

401 - Unauthorized

{}

Ejemplo

curl -X GET 'https://services.leadconnectorhq.com/voice-ai/dashboard/call-logs' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28'

const response = await fetch('https://services.leadconnectorhq.com/voice-ai/dashboard/call-logs', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.LEADWAY_TOKEN}`,
    Version: '2021-07-28',
  },
});
const data = await response.json();

import os, requests
response = requests.request(
    'GET',
    'https://services.leadconnectorhq.com/voice-ai/dashboard/call-logs',
    headers={
        'Authorization': f"Bearer {os.environ['LEADWAY_TOKEN']}",
        'Version': '2021-07-28',
    },
)
data = response.json()

<?php
$ch = curl_init('https://services.leadconnectorhq.com/voice-ai/dashboard/call-logs');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('LEADWAY_TOKEN'),
        'Version: 2021-07-28',
    ],
]);
$data = json_decode(curl_exec($ch), true);

Empezar

Scopes

Autorización

Query parameters

Respuestas

Ejemplo

​Autorización

​Query parameters

​Respuestas

​Ejemplo

Autorización

Query parameters

Respuestas

Ejemplo