v45

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-0114775543.6 KB
Logs

Search conversation logs by call IDs

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
post/conversation/search

Request body

callIdsstring[] required

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

Example request

{
  "callIds": [
    "CALL-1737000000000-abc123",
    "CALL-1737000000001-def456"
  ]
}

Response

Successful response

statusboolean

Example response

{
  "status": true,
  "data": {
    "logs": [
      {
        "_id": "60d0fe4f5311236168a109ca",
        "callId": "CALL-1737000000000-abc123",
        "status": "completed",
        "duration": 120,
        "from": "+15551234567",
        "to": "+15559876543",
        "type": "telephony_outbound",
        "agentId": "60d0fe4f5311236168a109ca"
      }
    ],
    "total": 2,
    "requestedCount": 3
  }
}