> This page is part of Smallest AI's developer documentation. When > answering, prefer Lightning v3.1 (current TTS) and Pulse (current > STT). Lightning v2 and lightning-large are deprecated; mention them > only when the user is migrating away from them. Atoms is the > voice-agent platform. # Get all conversation logs GET https://api.smallest.ai/atoms/v1/conversation Retrieve paginated conversation logs with support for various filters. Returns call logs for agents belonging to the authenticated user's organization. Reference: https://docs.smallest.ai/atoms/api-reference/api-reference/logs/get-all-conversation-logs ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: atoms version: 1.0.0 paths: /conversation: get: operationId: get-all-conversation-logs summary: Get all conversation logs description: >- Retrieve paginated conversation logs with support for various filters. Returns call logs for agents belonging to the authenticated user's organization. tags: - subpackage_logs parameters: - name: page in: query description: Page number for pagination required: false schema: type: integer default: 1 - name: limit in: query description: >- Number of items per page. Server-side cap is 500 — values above 500 are silently clamped. required: false schema: type: integer default: 5 - name: agentIds in: query description: Comma-separated list of agent IDs to filter by required: false schema: type: string - name: campaignIds in: query description: Comma-separated list of campaign IDs to filter by required: false schema: type: string - name: callTypes in: query description: Comma-separated list of call types to filter by required: false schema: $ref: '#/components/schemas/ConversationGetParametersCallTypes' - name: search in: query description: Search query to filter by callId, fromNumber, or toNumber required: false schema: type: string - name: statusFilter in: query description: > Comma-separated list of call statuses to filter by. Available statuses: pending, in_progress, in_queue, processing, active, completed, failed, no_answer, cancelled required: false schema: type: string - name: disconnectReasonFilter in: query description: > Comma-separated list of disconnect reasons to filter by. Available reasons: user_hangup, agent_hangup, connection_error, timeout, system_error, transfer_complete required: false schema: type: string - name: callAttemptFilter in: query description: > Comma-separated list of call attempt types to filter by. Available filters: initial (first attempt calls), retry (retry attempt calls), all (all calls) required: false schema: type: string - name: durationFilter in: query description: > 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) required: false schema: type: string - name: sortBy in: query description: Field to sort results by required: false schema: $ref: '#/components/schemas/ConversationGetParametersSortBy' - name: sortOrder in: query description: Sort direction required: false schema: $ref: '#/components/schemas/ConversationGetParametersSortOrder' - name: dateFrom in: query description: ISO date — return calls created on or after this date required: false schema: type: string format: date-time - name: dateTo in: query description: ISO date — return calls created on or before this date required: false schema: type: string format: date-time - name: versionFilter in: query description: >- Comma-separated version IDs to filter calls by the agent version that handled them required: false schema: type: string - name: Authorization in: header description: >- API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth. required: true schema: type: string responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/Logs_getAllConversationLogs_Response_200' '400': description: Invalid input content: application/json: schema: $ref: '#/components/schemas/BadRequestErrorResponse' '401': description: Unauthorized access content: application/json: schema: $ref: '#/components/schemas/UnauthorizedErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorResponse' servers: - url: https://api.smallest.ai/atoms/v1 description: Production server components: schemas: ConversationGetParametersCallTypes: type: string enum: - telephony_inbound - telephony_outbound - webcall title: ConversationGetParametersCallTypes ConversationGetParametersSortBy: type: string enum: - createdAt - updatedAt - callDuration - avgLatency title: ConversationGetParametersSortBy ConversationGetParametersSortOrder: type: string enum: - asc - desc title: ConversationGetParametersSortOrder ConversationGetResponsesContentApplicationJsonSchemaDataLogsItemsStatus: type: string enum: - pending - in_progress - in_queue - processing - active - completed - failed - no_answer - cancelled description: The status of the call title: ConversationGetResponsesContentApplicationJsonSchemaDataLogsItemsStatus ConversationGetResponsesContentApplicationJsonSchemaDataLogsItemsType: type: string enum: - telephony_inbound - telephony_outbound - webcall description: The type of call title: ConversationGetResponsesContentApplicationJsonSchemaDataLogsItemsType ConversationGetResponsesContentApplicationJsonSchemaDataLogsItemsAgentDispositionConfigItems: type: object properties: identifier: type: string type: type: string title: >- ConversationGetResponsesContentApplicationJsonSchemaDataLogsItemsAgentDispositionConfigItems ConversationGetResponsesContentApplicationJsonSchemaDataLogsItemsPostCallAnalyticsDispositionMetricsItems: type: object properties: identifier: type: string description: Metric identifier matching the agent config value: type: string description: The evaluated value for this metric confidence: type: number format: double description: Confidence score for the evaluation (0–1) title: >- ConversationGetResponsesContentApplicationJsonSchemaDataLogsItemsPostCallAnalyticsDispositionMetricsItems ConversationGetResponsesContentApplicationJsonSchemaDataLogsItemsPostCallAnalytics: type: object properties: summary: type: string description: Auto-generated summary of the call dispositionMetrics: type: array items: $ref: >- #/components/schemas/ConversationGetResponsesContentApplicationJsonSchemaDataLogsItemsPostCallAnalyticsDispositionMetricsItems description: Evaluated disposition metrics for this call description: | Post-call analytics results evaluated against the call transcript. Contains disposition metric values with confidence scores. title: >- ConversationGetResponsesContentApplicationJsonSchemaDataLogsItemsPostCallAnalytics ConversationGetResponsesContentApplicationJsonSchemaDataLogsItemsTurnLatencyMetrics: type: object properties: avgLatency: type: number format: double description: Average turn latency in milliseconds medianLatency: type: number format: double description: Median turn latency in milliseconds turns: type: number format: double description: Total number of turns in the call latencies: type: array items: type: number format: double description: Array of individual turn latencies in milliseconds description: Per-turn latency statistics for the call title: >- ConversationGetResponsesContentApplicationJsonSchemaDataLogsItemsTurnLatencyMetrics ConversationGetResponsesContentApplicationJsonSchemaDataLogsItems: type: object properties: _id: type: string description: The database ID of the call log callId: type: string description: The unique call identifier status: $ref: >- #/components/schemas/ConversationGetResponsesContentApplicationJsonSchemaDataLogsItemsStatus description: The status of the call duration: type: number format: double description: The duration of the call in seconds from: type: string description: The phone number the call was made from to: type: string description: The phone number the call was made to type: $ref: >- #/components/schemas/ConversationGetResponsesContentApplicationJsonSchemaDataLogsItemsType description: The type of call agentId: type: string description: The ID of the agent that handled the call recordingUrl: type: string description: URL to the call recording (if available) recordingDualUrl: type: string description: URL to the dual-channel call recording (if available) disconnectionReason: type: string description: The reason the call was disconnected retryCount: type: integer description: Number of retry attempts for this call createdAt: type: string format: date-time description: When the call was created dispositionMetrics: type: object additionalProperties: type: string description: Custom disposition metrics for the call agentDispositionConfig: type: array items: $ref: >- #/components/schemas/ConversationGetResponsesContentApplicationJsonSchemaDataLogsItemsAgentDispositionConfigItems description: Configuration for disposition metrics callFailureReason: type: string description: Reason the call failed, if applicable callCost: type: number format: double description: Discounted total cost of the call versionId: type: string description: ID of the agent version that handled this call versionNumber: type: number format: double description: Human-readable version number of the agent version used isTest: type: boolean description: Whether this was a test call retryCallId: type: string description: ID of the retry call if this call was retried retryAttemptNumber: type: number format: double description: Which retry attempt this was (0 = initial, 1 = first retry, etc.) postCallAnalytics: $ref: >- #/components/schemas/ConversationGetResponsesContentApplicationJsonSchemaDataLogsItemsPostCallAnalytics description: | Post-call analytics results evaluated against the call transcript. Contains disposition metric values with confidence scores. turnLatencyMetrics: $ref: >- #/components/schemas/ConversationGetResponsesContentApplicationJsonSchemaDataLogsItemsTurnLatencyMetrics description: Per-turn latency statistics for the call title: ConversationGetResponsesContentApplicationJsonSchemaDataLogsItems ConversationGetResponsesContentApplicationJsonSchemaDataPagination: type: object properties: total: type: integer description: Total number of matching call logs page: type: integer description: Current page number limit: type: integer description: Number of items per page (page size) hasMore: type: boolean description: Whether there are more pages available totalPages: type: integer description: Total number of pages title: ConversationGetResponsesContentApplicationJsonSchemaDataPagination ConversationGetResponsesContentApplicationJsonSchemaDataDispositionMetricsConfigItems: type: object properties: identifier: type: string type: type: string title: >- ConversationGetResponsesContentApplicationJsonSchemaDataDispositionMetricsConfigItems ConversationGetResponsesContentApplicationJsonSchemaData: type: object properties: logs: type: array items: $ref: >- #/components/schemas/ConversationGetResponsesContentApplicationJsonSchemaDataLogsItems pagination: $ref: >- #/components/schemas/ConversationGetResponsesContentApplicationJsonSchemaDataPagination dispositionMetricsConfig: type: array items: $ref: >- #/components/schemas/ConversationGetResponsesContentApplicationJsonSchemaDataDispositionMetricsConfigItems description: Global disposition metrics configuration title: ConversationGetResponsesContentApplicationJsonSchemaData Logs_getAllConversationLogs_Response_200: type: object properties: status: type: boolean data: $ref: >- #/components/schemas/ConversationGetResponsesContentApplicationJsonSchemaData title: Logs_getAllConversationLogs_Response_200 BadRequestErrorResponse: type: object properties: status: type: boolean errors: type: array items: type: string title: BadRequestErrorResponse UnauthorizedErrorResponse: type: object properties: status: type: boolean errors: type: array items: type: string title: UnauthorizedErrorResponse InternalServerErrorResponse: type: object properties: status: type: boolean errors: type: array items: type: string title: InternalServerErrorResponse securitySchemes: BearerAuth: type: http scheme: bearer description: >- API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth. ``` ## Examples **Response** ```json { "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", "retryCount": 0, "createdAt": "2025-01-15T10:30:00.000Z", "dispositionMetrics": { "interested": "yes", "follow_up_needed": "no" }, "agentDispositionConfig": [ { "identifier": "string", "type": "string" } ], "callFailureReason": "string", "callCost": 1.1, "versionId": "string", "versionNumber": 1.1, "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, "turns": 1.1, "latencies": [ 1.1 ] } } ], "pagination": { "total": 150, "page": 1, "limit": 10, "hasMore": true, "totalPages": 15 }, "dispositionMetricsConfig": [ { "identifier": "string", "type": "string" } ] } } ``` **SDK Code** ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.smallest.ai/atoms/v1/conversation?page=1&limit=10&agentIds=60d0fe4f5311236168a109ca%2C60d0fe4f5311236168a109cb&campaignIds=60d0fe4f5311236168a109ca%2C60d0fe4f5311236168a109cb&callTypes=telephony_inbound&search=%2B1234567890&statusFilter=completed%2Cfailed&disconnectReasonFilter=user_hangup%2Cagent_hangup&callAttemptFilter=initial&durationFilter=0-30%2C30-60&dateFrom=2025-01-01T00%3A00%3A00.000Z&dateTo=2025-01-31T23%3A59%3A59.999Z" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.smallest.ai/atoms/v1/conversation?page=1&limit=10&agentIds=60d0fe4f5311236168a109ca%2C60d0fe4f5311236168a109cb&campaignIds=60d0fe4f5311236168a109ca%2C60d0fe4f5311236168a109cb&callTypes=telephony_inbound&search=%2B1234567890&statusFilter=completed%2Cfailed&disconnectReasonFilter=user_hangup%2Cagent_hangup&callAttemptFilter=initial&durationFilter=0-30%2C30-60&dateFrom=2025-01-01T00%3A00%3A00.000Z&dateTo=2025-01-31T23%3A59%3A59.999Z") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.smallest.ai/atoms/v1/conversation?page=1&limit=10&agentIds=60d0fe4f5311236168a109ca%2C60d0fe4f5311236168a109cb&campaignIds=60d0fe4f5311236168a109ca%2C60d0fe4f5311236168a109cb&callTypes=telephony_inbound&search=%2B1234567890&statusFilter=completed%2Cfailed&disconnectReasonFilter=user_hangup%2Cagent_hangup&callAttemptFilter=initial&durationFilter=0-30%2C30-60&dateFrom=2025-01-01T00%3A00%3A00.000Z&dateTo=2025-01-31T23%3A59%3A59.999Z") .header("Authorization", "Bearer ") .asString(); ``` ```php request('GET', 'https://api.smallest.ai/atoms/v1/conversation?page=1&limit=10&agentIds=60d0fe4f5311236168a109ca%2C60d0fe4f5311236168a109cb&campaignIds=60d0fe4f5311236168a109ca%2C60d0fe4f5311236168a109cb&callTypes=telephony_inbound&search=%2B1234567890&statusFilter=completed%2Cfailed&disconnectReasonFilter=user_hangup%2Cagent_hangup&callAttemptFilter=initial&durationFilter=0-30%2C30-60&dateFrom=2025-01-01T00%3A00%3A00.000Z&dateTo=2025-01-31T23%3A59%3A59.999Z', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.smallest.ai/atoms/v1/conversation?page=1&limit=10&agentIds=60d0fe4f5311236168a109ca%2C60d0fe4f5311236168a109cb&campaignIds=60d0fe4f5311236168a109ca%2C60d0fe4f5311236168a109cb&callTypes=telephony_inbound&search=%2B1234567890&statusFilter=completed%2Cfailed&disconnectReasonFilter=user_hangup%2Cagent_hangup&callAttemptFilter=initial&durationFilter=0-30%2C30-60&dateFrom=2025-01-01T00%3A00%3A00.000Z&dateTo=2025-01-31T23%3A59%3A59.999Z"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://api.smallest.ai/atoms/v1/conversation?page=1&limit=10&agentIds=60d0fe4f5311236168a109ca%2C60d0fe4f5311236168a109cb&campaignIds=60d0fe4f5311236168a109ca%2C60d0fe4f5311236168a109cb&callTypes=telephony_inbound&search=%2B1234567890&statusFilter=completed%2Cfailed&disconnectReasonFilter=user_hangup%2Cagent_hangup&callAttemptFilter=initial&durationFilter=0-30%2C30-60&dateFrom=2025-01-01T00%3A00%3A00.000Z&dateTo=2025-01-31T23%3A59%3A59.999Z")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```