WIwithallo
Conversations

Search Conversations

Changed on

Deprecated. Use POST /v2/api/conversations/items/search instead. This endpoint still responds, but it is no longer maintained and is not part of the current API reference.

Search calls and SMS for a specific contact. Returns paginated results including call recordings, transcripts, AI summaries, and text messages.

get/v1/api/contact/{contact_id}/conversation

Request

  • Base URL
    https://api.withallo.com
  • URL
    https://api.withallo.com/v1/api/contact/{contact_id}/conversation
  • Auth
    API key in header Authorization

Path parameters

contact_idstring required
Example:cnt_abc123

The unique identifier of the contact (e.g., "cnt_abc123")

Query parameters

sizeinteger

Number of results per page. Must be between 1 and 100.

pageinteger

Page number (0-indexed).

allo_numberstring
Example:+1234567890

Filter conversations by a specific Allo phone number (E.164 format).

Response

Conversation retrieved successfully

Example response

{
  "data": {
    "results": [
      {
        "call": {
          "id": "call_abc123",
          "from_number": "+1234567890",
          "to_number": "+0987654321",
          "length_in_minutes": 5.5,
          "result": "ANSWERED",
          "summary": "Customer inquired about order status",
          "tag": "support",
          "start_date": "2024-01-15T10:30:00",
          "transcript": [
            {
              "text": "Hello, how can I help you today?",
              "time": "2024-01-15T10:30:15",
              "start_seconds": 15,
              "end_seconds": 18.5
            }
          ]
        },
        "message": {
          "from_number": "+1234567890",
          "sender_id": "MyCompany",
          "to_number": "+0987654321",
          "content": "Hello, this is a test message",
          "start_date": "2024-01-15T10:30:00"
        }
      }
    ],
    "metadata": {
      "pagination": {
        "total_pages": 5
      }
    }
  }
}

Changes