v45

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-0114775543.6 KB

Logs

Get all conversation logs

Retrieve paginated conversation logs with support for various filters. Returns call logs for agents belonging to the authenticated user's organization.

get/conversation

Query parameters

pageinteger

Page number for pagination

limitinteger

Number of items per page. Server-side cap is 500 — values above 500 are silently clamped.

agentIdsstring

Comma-separated list of agent IDs to filter by

campaignIdsstring

Comma-separated list of campaign IDs to filter by

callTypes'telephony_inbound' | 'telephony_outbound' | 'webcall'

Comma-separated list of call types to filter by

searchstring

Search query to filter by callId, fromNumber, or toNumber

statusFilterstring

Comma-separated list of call statuses to filter by. Available statuses: pending, in_progress, in_queue, processing, active, completed, failed, no_answer, cancelled

disconnectReasonFilterstring

Comma-separated list of disconnect reasons to filter by. Available reasons: user_hangup, agent_hangup, connection_error, timeout, system_error, transfer_complete

callAttemptFilterstring

Comma-separated list of call attempt types to filter by. Available filters: initial (first attempt calls), retry (retry attempt calls), all (all calls)

durationFilterstring

Comma-separated list of duration ranges to filter by. Available ranges: 0-30 (0-30 seconds), 30-60 (30-60 seconds), 1-5 (1-5 minutes), 5+ (more than 5 minutes)

sortBy'createdAt' | 'updatedAt' | 'callDuration' | 'avgLatency'

Field to sort results by

sortOrder'asc' | 'desc'

Sort direction

dateFromstring date-time

ISO date — return calls created on or after this date

dateTostring date-time

ISO date — return calls created on or before this date

versionFilterstring

Comma-separated version IDs to filter calls by the agent version that handled them

Response

Successful response

statusboolean

Example response

{
  "status": true,
  "data": {
    "logs": [
      {
        "_id": "60d0fe4f5311236168a109ca",
        "callId": "CALL-1737000000000-abc123",
        "status": "completed",
        "duration": 120,
        "from": "+15551234567",
        "to": "+15559876543",
        "type": "telephony_outbound",
        "agentId": "60d0fe4f5311236168a109ca",
        "recordingUrl": "https://storage.example.com/recordings/call-123.mp3",
        "recordingDualUrl": "https://storage.example.com/recordings/call-123-dual.mp3",
        "disconnectionReason": "user_hangup",
        "createdAt": "2025-01-15T10:30:00.000Z",
        "dispositionMetrics": {
          "interested": "yes",
          "follow_up_needed": "no"
        }
      }
    ],
    "pagination": {
      "total": 150,
      "page": 1,
      "limit": 10,
      "hasMore": true,
      "totalPages": 15
    }
  }
}