For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Atoms PlatformProduct OverviewDeveloper GuideAPI ReferenceMCPIntegrationsDeveloper ToolsChangelog
Atoms PlatformProduct OverviewDeveloper GuideAPI ReferenceMCPIntegrationsDeveloper ToolsChangelog
  • User
    • GETGet user details
  • Organization
    • GETGet organization details
  • Agent templates
    • GETGet agent templates
    • POSTCreate agent from template
  • Agents
    • GETGet all agents
    • POSTCreate a new agent
    • GETGet agent by ID
    • PATCHUpdate agent metadata
    • DELDelete an agent
    • POSTDuplicate agent to another organization
    • GETGet agent workflow
    • PATCHUpdate workflow configuration
  • Logs
    • GETGet all conversation logs
    • POSTSearch conversation logs by call IDs
    • GETGet conversation log by ID
  • Calls
    • POSTStart an outbound call
  • Campaigns
    • GETRetrieve all campaigns
    • POSTCreate a campaign
    • GETGet a campaign
    • DELDelete a campaign
    • POSTStart a campaign
    • POSTPause a campaign
  • Knowledge base
    • GETGet all knowledge bases
    • POSTCreate a knowledge base
    • GETGet a knowledge base
    • DELDelete a knowledge base
    • GETGet all knowledge base items
    • DELDelete a knowledge base item
    • POSTUpload a PDF file to a knowledge base
  • Phone numbers
    • GETGet acquired phone numbers
    • POSTImport a SIP phone number
  • Webhooks
    • GETGet webhooks
    • POSTCreate a webhook
    • DELDelete a webhook
    • GETGet webhook subscriptions for an agent
    • POSTCreate webhook subscriptions for an agent
    • DELDelete webhook subscriptions for an agent
    • POSTpre-conversation
    • POSTpost-conversation
    • POSTanalytics-completed
  • Audience
    • GETGet all audiences
    • POSTCreate audience with CSV upload
    • GETGet audience by ID
    • DELDelete audience
    • GETGet audience members
    • POSTAdd audience members
    • DELDelete audience members
    • GETSearch audience members
  • Realtime Agent
    • WSSAgent WebSocket
  • Live Transcripts
    • STREAMSubscribe to live call events (SSE)
  • Compliance
    • GETGet compliance status
    • GETGet compliance requirements
    • POSTSubmit a compliance application
    • PATCHResubmit a rejected compliance application
    • POSTRefresh compliance application status
  • Agent Versioning Drafts
    • GETList active drafts
    • POSTCreate a draft
    • GETGet draft detail
    • DELDiscard a draft
    • PATCHRename a draft
    • GETGet draft diff
    • POSTPublish a draft
    • POSTTest call with draft config
    • PATCHEdit draft config (prompt, tools, post-call metrics, voice, etc.)
  • Agent Versioning Versions
    • GETList published versions
    • GETDiff two versions
    • GETCompare metrics between two versions
    • GETGet version detail
    • PATCHUpdate version metadata (label, description, pin only)
    • PATCHActivate a version
    • POSTTest call with version config
LogoLogo
Voice AgentsModels
Voice AgentsModels
Logs

Get all conversation logs

||View as Markdown|
GET
https://api.smallest.ai/atoms/v1/conversation
GET
/atoms/v1/conversation
1from smallest_ai import SmallestAI
2
3client = SmallestAI(
4 token="YOUR_TOKEN_HERE",
5)
6
7client.atoms.logs.get_all_conversation_logs(
8 page=1,
9 limit=10,
10 agent_ids="60d0fe4f5311236168a109ca,60d0fe4f5311236168a109cb",
11 campaign_ids="60d0fe4f5311236168a109ca,60d0fe4f5311236168a109cb",
12 call_types="telephony_inbound",
13 search="+1234567890",
14 status_filter="completed,failed",
15 disconnect_reason_filter="user_hangup,agent_hangup",
16 call_attempt_filter="initial",
17 duration_filter="0-30,30-60",
18)
1{
2 "status": true,
3 "data": {
4 "logs": [
5 {
6 "_id": "60d0fe4f5311236168a109ca",
7 "callId": "CALL-1737000000000-abc123",
8 "status": "completed",
9 "duration": 120,
10 "from": "+15551234567",
11 "to": "+15559876543",
12 "type": "telephony_outbound",
13 "agentId": "60d0fe4f5311236168a109ca",
14 "agentName": "Sales Agent",
15 "recordingUrl": "https://storage.example.com/recordings/call-123.mp3",
16 "recordingDualUrl": "https://storage.example.com/recordings/call-123-dual.mp3",
17 "disconnectionReason": "user_hangup",
18 "retryCount": 0,
19 "createdAt": "2025-01-15T10:30:00.000Z",
20 "dispositionMetrics": {
21 "interested": "yes",
22 "follow_up_needed": "no"
23 },
24 "agentDispositionConfig": [
25 {
26 "identifier": "string",
27 "type": "string"
28 }
29 ]
30 }
31 ],
32 "pagination": {
33 "total": 150,
34 "page": 1,
35 "limit": 10,
36 "hasMore": true,
37 "totalPages": 15
38 },
39 "dispositionMetricsConfig": [
40 {
41 "identifier": "string",
42 "type": "string"
43 }
44 ]
45 }
46}
Retrieve paginated conversation logs with support for various filters. Returns call logs for agents belonging to the authenticated user's organization.
Was this page helpful?
Previous

Update workflow configuration

Next

Search conversation logs by call IDs

Built with

Authentication

AuthorizationBearer

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

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
dataobject

Errors

400
Bad Request Error
401
Unauthorized Error
500
Internal Server Error