Get all conversation logs | Smallest AI Docs

from smallest_ai import SmallestAI
client = SmallestAI(
    token="YOUR_TOKEN_HERE"
)
client.atoms.logs.get_all_conversation_logs(
    page=1,
    limit=10,
    agent_ids="60d0fe4f5311236168a109ca,60d0fe4f5311236168a109cb",
    campaign_ids="60d0fe4f5311236168a109ca,60d0fe4f5311236168a109cb",
    call_types="telephony_inbound",
    search="+1234567890",
    status_filter="completed,failed",
    disconnect_reason_filter="user_hangup,agent_hangup",
    call_attempt_filter="initial",
    duration_filter="0-30,30-60"
)

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

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

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

pageintegerOptional>=1Defaults to 1

Page number for pagination

limitintegerOptional>=1Defaults to 5

Number of items per page

agentIdsstringOptional

Comma-separated list of agent IDs to filter by

campaignIdsstringOptional

Comma-separated list of campaign IDs to filter by

callTypesenumOptional

Comma-separated list of call types to filter by

Allowed values:

searchstringOptional

Search query to filter by callId, fromNumber, or toNumber

statusFilterstringOptional

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

disconnectReasonFilterstringOptional

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

callAttemptFilterstringOptional

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

durationFilterstringOptional

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)

Response

Successful response

statusboolean or null

dataobject or null

Authentication

Query parameters

Response

Errors