v1

latestOpenAPI 3.0.32026-07-264955102.7 KB

Conversations

Search all conversations

Search and filter items across all conversations. Supports keyword search across transcripts, summaries, and message content.

post/v2/api/conversations/items/search

Request body

allo_numberstring

contact_numberstring

user_idstring

direction'INBOUND' | 'OUTBOUND'

type'CALL' | 'SMS' | 'ALL'

result'ANSWERED' | 'VOICEMAIL' | 'TRANSFERRED'

tagsstring[]

unreadboolean

unrespondedboolean

searchstring

Keyword search (not natural language). Extract keywords from the user's question. Terms are AND'd with prefix matching — 'billing refund' matches items containing both words, 'bill' matches 'billing'. Searches across call transcripts, summaries, and SMS content.

sort'DATE_DESC' | 'DATE_ASC' | 'RELEVANCE'

extendstring

pageinteger

sizeinteger

Example request

{
  "date": {
    "from": "2026-03-25",
    "to": "2026-04-21"
  }
}

Response

Search results

Example response

{
  "data": [
    {
      "id": "cll-abc123",
      "allo_number": "+14155550100",
      "contact_number": "+14155551234",
      "contacts": [
        {
          "id": "cnt-abc123",
          "name": "Sarah Johnson",
          "company": {
            "id": "com-xyz789",
            "name": "Acme Corp"
          },
          "deals": [
            {
              "id": "dea-def456",
              "name": "Enterprise Plan"
            }
          ]
        }
      ],
      "user": {
        "id": "usr-abc123",
        "name": "John",
        "email": "john@acme.com"
      }
    }
  ]
}