Search conversation logs by call IDs

POST

https://api.smallest.ai/atoms/v1/conversation/search

POST

/atoms/v1/conversation/search

from smallestai import SmallestAI
client = SmallestAI(
    token="YOUR_TOKEN_HERE",
)
client.atoms.logs.search_conversation_logs_by_call_i_ds(
    call_ids=[
        "CALL-1737000000000-abc123",
        "CALL-1737000000001-def456"
    ],
)

{
  "status": true,
  "data": {
    "logs": [
      {
        "_id": "60d0fe4f5311236168a109ca",
        "callId": "CALL-1737000000000-abc123",
        "status": "completed",
        "duration": 120,
        "from": "+15551234567",
        "to": "+15559876543",
        "type": "telephony_outbound",
        "agentId": "60d0fe4f5311236168a109ca",
        "recordingUrl": "string",
        "recordingDualUrl": "string",
        "disconnectionReason": "string",
        "retryCount": 1,
        "createdAt": "2024-01-15T09:30:00Z",
        "callFailureReason": "string",
        "callCost": 1.1,
        "versionId": "string",
        "isTest": true,
        "retryCallId": "string",
        "retryAttemptNumber": 1.1,
        "postCallAnalytics": {
          "summary": "string",
          "dispositionMetrics": [
            {
              "identifier": "string",
              "value": "string",
              "confidence": 1.1
            }
          ]
        },
        "turnLatencyMetrics": {
          "avgLatency": 1.1,
          "medianLatency": 1.1,
          "minLatency": 1.1,
          "maxLatency": 1.1,
          "turns": 1.1,
          "latencies": [
            1.1
          ],
          "transitions": [
            {
              "turn": 1.1,
              "user_end": 1.1,
              "bot_start": 1.1,
              "latency": 1.1
            }
          ],
          "processedAt": "2024-01-15T09:30:00Z"
        }
      }
    ],
    "total": 2,
    "requestedCount": 3
  }
}

Fetch specific conversation logs by their callIds. This endpoint allows you to retrieve up to 100 specific calls at once. Only returns calls that belong to agents in your organization (security check enforced). Unlike the GET /conversation endpoint, this endpoint can also return retry calls (non-root calls).

Differences from GET /conversation response: each log item has the same base structure but the following three fields are not included here:

dispositionMetrics — not enriched
agentDispositionConfig — not enriched
versionNumber — not enriched

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Request

This endpoint expects an object.

callIdslist of stringsRequired

Array of callIds to fetch. Format: CALL-{13-digit-timestamp}-{6-char-hex} (e.g. CALL-1737000000000-abc123). Minimum 1, maximum 100 per request.

Response

Successful response

statusbooleanOptional

dataobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error