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.

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

Authorization

NameTypeRequiredExampleDescription
AuthorizationstringYesBearer token generated from the Leadway portal. See Authentication.
VersionstringYes2021-07-28API version.

Query parameters

NameTypeRequiredExampleDescription
locationIdstringYesAccount identifier. Filters results to this account.
agentIdstringNo507f1f77bcf86cd799439011Agent identifier. When provided, returns logs for this agent only.
contactIdstringNocontact123,contact456Contact IDs (comma-separated) to filter by.
callTypestringNoCall type filter.
startDatenumberNo1679308800000Start date filter (Unix timestamp). Must be less than endDate. Both startDate and endDate must be provided together.
endDatenumberNo1679395199000End date filter (Unix timestamp). Must be greater than startDate. Both startDate and endDate must be provided together.
actionTypestringNoSMS,CALL_TRANSFER,WORKFLOW_TRIGGERAction type filter for call logs (comma-separated ACTION_TYPE values)
sortBystringNoField to sort by. Defaults to newest if omitted.
sortstringNoSort direction. Applies only when sortBy is provided.
pagenumberNoPage number (1-based).
pageSizenumberNoPage size (max 50).

Responses

200 - Successfully retrieved call logs
  • total (number, required): Total number of items Example: 150

  • page (number, required): Page number starting from 1 Example: 2

  • pageSize (number, required): Number of items per page Example: 10

  • callLogs (object[], required): Array of call logs

    • id (string, required): Unique identifier for the call Example: 507f1f77bcf86cd799439011

    • contactId (string): Associated contact ID Example: 507f1f77bcf86cd799439012

    • agentId (string, required): Agent ID associated with the call Example: 507f1f77bcf86cd799439013

    • isAgentDeleted (boolean, required): Whether the agent is deleted Example: False

    • fromNumber (string): Caller phone number Example: +1234567890

    • createdAt (string, required): Timestamp when the call was created Example: 2024-01-15T10:30:00.000Z

    • duration (number, required): Call duration in seconds Example: 180

    • trialCall (boolean, required): Whether this call was a trial call Example: False

    • executedCallActions (object[], required): Actions performed during the call. Note: The APPOINTMENT_BOOKING action will only be visible in executedCallActions from Sep 9th 2025.

      • actionId (string): Action ID reference Example: 507f1f77bcf86cd799439015

      • actionType (string, required): Action type Possible values: 'CALL_TRANSFER', 'DATA_EXTRACTION', 'IN_CALL_DATA_EXTRACTION', 'WORKFLOW_TRIGGER', 'SMS', 'APPOINTMENT_BOOKING', 'CUSTOM_ACTION', 'KNOWLEDGE_BASE' Example: SMS

      • actionName (string, required): Action name Example: Send SMS Confirmation

      • actionParameters (object): Action parameters - structure varies by actionType

      • executedAt (string): When the action was executed Example: 2024-01-15T10:32:00.000Z

      • triggerReceivedAt (string): When the trigger was received Example: 2024-01-15T10:31:45.000Z

    • summary (string, required): Call summary Example: Customer called to inquire about product pricing and was transferred to sales team.

    • transcript (string, required): Call transcript Example: bot: Hello, how can I help you today? human: I would like to know about your pricing...

    • translation (object): Transcript translation details

    • extractedData (object): Dynamic data extracted from the call based on agent configuration

    • messageId (string): Message identifier associated with the call Example: 507f1f77bcf86cd799439014

json
{
  "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
json
{}
401 - Unauthorized
json
{}

Example

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

Last updated October 26, 2026

Was this page helpful?