WIwithallo
Conversations

Search all conversations

Changed on

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

post/v2/api/conversations/items/search

Request

  • Base URL
    https://api.withallo.com
  • URL
    https://api.withallo.com/v2/api/conversations/items/search
  • Auth
    API key in header Authorization

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"
      },
      "extracted_data": {
        "contact": {
          "name": "Marie Dupont",
          "company": "Vibrant Events",
          "job_title": "Office manager",
          "website": "vibrantevents.com",
          "address": "12 rue de la Paix, Paris",
          "emails": [
            "marie@vibrantevents.com"
          ]
        }
      }
    }
  ]
}

Changes

  • 46c77103dd14Revision changes
    • warning

      added the new BLOCKED enum value to the /// response property for the response status

    • warning

      added the new CLOSED enum value to the /// response property for the response status

    • warning

      added the new FAILED enum value to the /// response property for the response status

    • warning

      added the new FAILED_EXTERNAL enum value to the /// response property for the response status

    • warning

      added the new RECEIVED enum value to the /// response property for the response status

    • warning

      added the new TRANSFERRED_AI enum value to the /// response property for the response status

    • warning

      added the new TRANSFERRED_EXTERNAL enum value to the /// response property for the response status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      removed the TRANSFERRED enum value from the /// response property for the response status