---
title: "Get all conversation logs"
method: GET
path: "/conversation"
tags: ["Logs"]
---

# Get all conversation logs

`GET /conversation`

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

## Query parameters

- `page` integer
- `limit` integer
- `agentIds` string
- `campaignIds` string
- `callTypes` 'telephony_inbound' | 'telephony_outbound' | 'webcall'
- `search` string
- `statusFilter` string
- `disconnectReasonFilter` string
- `callAttemptFilter` string
- `durationFilter` string
- `sortBy` 'createdAt' | 'updatedAt' | 'callDuration' | 'avgLatency'
- `sortOrder` 'asc' | 'desc'
- `dateFrom` string, date-time
- `dateTo` string, date-time
- `versionFilter` string

## Response `200`

Successful response

- object
  - `status` boolean
  - `data` object
    - `logs` object[]
      - `_id` string — The database ID of the call log
      - `callId` string — The unique call identifier
      - `status` 'pending' | 'in_progress' | 'in_queue' | 'processing' | 'active' | 'completed' | 'failed' | 'no_answer' | 'cancelled' — The status of the call
      - `duration` number — The duration of the call in seconds
      - `from` string — The phone number the call was made from
      - `to` string — The phone number the call was made to
      - `type` 'telephony_inbound' | 'telephony_outbound' | 'webcall' — The type of call
      - `agentId` string — The ID of the agent that handled the call
      - `recordingUrl` string — URL to the call recording (if available)
      - `recordingDualUrl` string — URL to the dual-channel call recording (if available)
      - `disconnectionReason` string — The reason the call was disconnected
      - `retryCount` integer — Number of retry attempts for this call
      - `createdAt` string, date-time — When the call was created
      - `dispositionMetrics` object — Custom disposition metrics for the call
      - `agentDispositionConfig` object[] — Configuration for disposition metrics
        - `identifier` string
        - `type` string
      - `callFailureReason` string — Reason the call failed, if applicable
      - `callCost` number — Discounted total cost of the call
      - `versionId` string — ID of the agent version that handled this call
      - `versionNumber` number — Human-readable version number of the agent version used
      - `isTest` boolean — Whether this was a test call
      - `retryCallId` string — ID of the retry call if this call was retried
      - `retryAttemptNumber` number — Which retry attempt this was (0 = initial, 1 = first retry, etc.)
      - `postCallAnalytics` object — Post-call analytics results evaluated against the call transcript. Contains disposition metric values with confidence scores.
        - `summary` string — Auto-generated summary of the call
        - `dispositionMetrics` object[] — Evaluated disposition metrics for this call
          - `identifier` string — Metric identifier matching the agent config
          - `value` string — The evaluated value for this metric
          - `confidence` number — Confidence score for the evaluation (0–1)
      - `turnLatencyMetrics` object — Per-turn latency statistics for the call
        - `avgLatency` number — Average turn latency in milliseconds
        - `medianLatency` number — Median turn latency in milliseconds
        - `minLatency` number — Minimum turn latency in milliseconds
        - `maxLatency` number — Maximum turn latency in milliseconds
        - `turns` number — Total number of turns in the call
        - `latencies` number[] — Array of individual turn latencies in milliseconds
        - `transitions` object[] — Per-turn timing breakdown.
          - `turn` number
          - `user_end` number — Timestamp (ms) when the user finished speaking
          - `bot_start` number — Timestamp (ms) when the agent started responding
          - `latency` number — Latency for this turn in milliseconds
        - `processedAt` string, date-time — When the latency metrics were computed.
    - `pagination` object
      - `total` integer — Total number of matching call logs
      - `page` integer — Current page number
      - `limit` integer — Number of items per page (page size)
      - `hasMore` boolean — Whether there are more pages available
      - `totalPages` integer — Total number of pages
    - `dispositionMetricsConfig` object[] — Global disposition metrics configuration
      - `identifier` string
      - `type` string

## Other responses

- `400` — Invalid input
- `401` — Unauthorized access
- `500` — Internal server error

---

[API](https://skmtc.net/smallest-inc/apis/agent-management-api.md) · [All operations](https://skmtc.net/smallest-inc/apis/agent-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smallest-inc/agent-management-api/revisions/c2d0eb64b01a/schema)